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PREFACE 



This manual describes the SDS 940 Time-Sharing System (Version 2.0). The design and imple- 
mentation of the system is explained, as well as certain of its operational features. The manual 
covers this in three major parts: Monitor, Executive, and subsystems. 

Chapters 2-11 deal with the Monitor, chapters 12-19 discuss the Executive, and chapters 20- 
27 explain the various system programmed operators (SYSPOPS) and branch system routines 
(BRS) that can be used with this system. 

Illustrations and explanations are also given of important tables associated with the system, 
such as the PAC Table, Phantom User Queue Entry, Job Table, Pseudo Memory Table, etc. 

This publication is a reference guide for experienced programmers. It assumes that the reader 
is familiar with the basic concepts of the SDS 940 Time-Sharing System. Additional informa- 
tion about the system can be obtained from the related publications list. 



1. INTRODUCTION 



The SDS Time-Sharing System (TSS) links the 940 CPU with 
up to 32 remote terminals. The system consists of three 
main parts: Monitor, Executive, and subsystems. The mon- 
itor executes in monitor mode while the Executive and the 
subsystems execute in user mode. 

Both RAD and disc storage are required, the RAD for storing 
the subsystems and for swapping and the disc for user's files, 
file directories, accounting information, and copies of the 
Monitor and Executive 

THE MONITOR 

The Monitor is the portion of the system concerned with 

scheduling 

input/output operations 

interrupt processing 

memory allocation 

swapping of programs and data from disc and RAD to 
and from core memory 

control of active programs 

Initially when the system is put into operation, the compu- 
ter is operating in the 930 mode. The execution of an EOM 
022000B puts the computer into the 940 Monitor mode. 
When the Monitor executes a branch instruction with bit 
of the branch instruction set, user hardware relabeling is 
invoked and a transfer is made to user mode. Once the 
computer Is In user mode, it will revert to Monitor mode 
by the occurrence of an interrupt or trap, or the execution 
of a SYSPOP (System Programmed Operator). 

The basic program unit with which the 940 time-sharing 
system is concerned is called a fork —a self-contained body 
of code consisting of a main program and all subroutines 
necessary to perform a particular process. A fork may have 
a maximum of 16K memory active at any time. The "fork- 
ing structure" concept Is analogous to the "overlay struc- 
ture" concept used by many batch monitors. An overlay 
structure consists of segments of a program that, when 
loaded, will reside In the same locations in memory at dif- 
ferent times. At any given time only a part of an overlay 
structure will be active. When this segment completes exe- 
cution It can take action to bring In another segment of the 
overlay structure. 

Similarly, a user can have only one fork active at any given 
time. While this fork is active it can take action to estab- 
lish and transfer control to o lower fork. When the lower 
fork has finished executing. It can transfer control back to 
the porent fork. The lower fork may share pages of memory 
with any of the parent forks, and it may acquire more mem- 
ory Independently of the parent. While the lower fork Is 
executing, the pages of the parent fork that are not being 
shared with the lower fork hove most likely been swapped 
out to the RAD. However, sufficient information has been 



retained to establish the environment of the parent fork when 
the lower fork terminates. 

Figure 1 illustrates a forking structure for four users (the 
Phantom User is discussed in Chapter 2). A user may have 
a total of 32K in his forking structure. The user is not 
charged for the memory required by the reentrant part (pro- 
cedural part) of the reentrant subsystems, A maximum of 8 
forks is allowed In the user's forking structure. 
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Figure 1. Typical Forking Structure 
The most important aspects of the forking structure are that 

1. The software deals with forks; the Scheduler activates 
a fork, not a job or a user. 

2. A user can have only one fork in his forking structure 
currently active. This fork Is either running or wait- 
ing on one of the queues to be allotted a time slice. 
The rest of the forks In the user's forking structure 
have been dismissed and will be reactivated when the 
lower fork terminates. 

Figure 2 Is a diagram of the Monitor showing Its functional 
parts, not the actual core layout. The Monitor pages are 
"locked", that is, not available for swapping. The locking 
Is software-Implemented. If a fork initiates an I/O opera- 
tion. It will be dismissed to allow activation of another 
fork while its I/O Is In progress. Upon completion of the 
I/O, the original fork Is reactivated. The page where the 
I/O Is being performed will be locked until the operation 
Is completed, although the rest of the fork's memory may 
be swapped. 

The scheduler Is the most Important element of the 940 
Monitor. It decides which fork to activate and It calls the 
swnDDer which collect? from the RAD any pages the fork 
requlres. When the swapping has been completed, the 
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Figure 2. Concept of Locked Pages 

scheduler transfers control to the fork and, by so doing, 
effects a transfer to the user mode. The fork will execute 
until a specified quantum of time has elapsed, or until the 
fork requests I/O and a call must be made to activate an 
I/O device, or until the fork takes some action that dis- 
misses itself. At this time, control is returned to the sched- 
uler, which finds another fork to activate. 

A 64K system utilizes the "compute while swap" option. 
With this option, the memory a fork requires is allocated, 
the necessary RAD I/O operations are initiated, and the 
fork is placed on the swap wait queue (SWQ), This fork 
will remain on SWQ until all of the pages the fork requires 
have become core-resident. 

After the fork has been placed on SWQ, the system then acti- 
vates that fork on SWQ that has all of its memory core- 
resident, or the resident user fork. The resident user fork is 
the last fork that was dismissed forquantum time overflow. Since 
such a fork is compute-bound, the system can be executing 
this fork while the other fork is being swapped into core. 

When a fork becomes the resident user, the pages it requires 
are locked so that the system can immediately transfer to this 
fork when a swap has been initiated. When the resident user 
is activated, its pages are unlocked, and the fork loses its 
Identity OS the resident user. The fork will execute until it 
is dismissed for any of the usual reasons. 

If there is no resident user (no forks have been dismissed for 
quantum overflow) the system will wait until one of the 



forks on SWQ has al. of its pages core-resident. There 
can be a maximum of two forks on SWQ. 

When the swapper activates a fork, all of the pages belong- 
ing to the fork are marked "read-only". If the fork exe- 
cutes any instruction that alters memory, a trap routine 
will change the status of the page to "not read only". The 
amount of RAD I/O required is significantly reduced in 
this way. The swapper does not have to output a "read- 
only" page since a copy already exists on the RAD. The 
only pages in the system that are truly read-only, however, 
are the reentrant Executive or subsystem pages. The trap 
routine produces an error condition if a read-only trap 
occurs in one of these reentrant pages. 

THE EXECUTIVE 

The Executive is the intermediary between the Monitor 
and the user. It is concerned with 

• the command language through which the user controls 
the system from his teletype 

• identification of the various users 

• the specification of the limits of each user's access to 
the system 

• control of the directory of symbolic file names, and 
backup storage for these files 

• requests for a subsystem. 

The Executive is a reentrant program that uses a Temporary 
Storage (TS) page, 2048 words, to accomplish reentrance. 
Each user is assigned a TS page when he dials onto the sys- 
tem. Therefore, each user actually has a maximum of 30K 
available memory (32K minus the TS page). 

The TS page contains the l/O buffers, various constants 
pertaining to the user, and reserved storage for the B and 
X registers. Any request by the user for I/O involves a 
transfer of data from the device to a TS page buffer. 

The access a user has to the system is defined by his status. 
The user's status determines what Executive commands are 
available to him and what SYSPOPS he may execute. Four 
levels of status are available: 

1 . Operator 

2. System 

3. Subsystem 

4. User (the Executive commands available to the user 
ore explained in the "Terminal Users Guide" 
90-11 -ISA) 

A.ny of the above may be granted peripheral status or sub- 
system class status, or both. With peripheral status the 
user may access certain peripheral devices through the 
medium of the Executive command structure. Subsystem 
class status permits the user the use of TAP and DDT. 



Monitor/Executive 



SUBSYSTEMS 

Subsystems are major processors such as FORTRAN II, CAL, 
QED, etc. that perform specialized functions. These sub- 
systems are programs that are permanently connected to the 
main system. Each subsystem is called by name through the 
Executive, and the Executive then establishes a lower fork 
for the subsystem. 



The processors implemented as 940 subsystems have such a 
high rate or usage that they have been written as reentrant 
programs, enabling many users to share the same processor 
simultaneously. 

Programming reference information on the major subsystems 
is contained in individual manuals listed under related pub- 
lications in front of this manual. 



2. SCHEDULER 



PROGRAM ACTIVATION TABLE 

Since a time-sharing environment involves the dynamic 
swapping in and out of user forks, tables must be maintained 
that enable the system to establish the program environment 
the fork had before it was dismissed. Each fork has a PAC 
table (PACT) associated with it. The format of the PACT is 
shown in Figure 3. 

Note that the PACT contains locations for saving the pro- 
gram counter, P, and the contents of the A register. The 
B and X registers are saved in the TS block. The PACT also 
contains two of the three pseudo-relabeling registers for the 
fork. The third, which specifies the TS block, is kept in 
one of the job tables (RL3). Pseudo-relabeling is discussed 
in detail later in this chapter. The word PTEST determines 
the conditions under which the fork should be reactivated 
if it is not currently running. The panic table address in 
PTAB and the two pointers called PFORK and PDOWN are 
discussed under "Panic Conditions", 

Once the fork has become active, it can be in one of five 
states 

1. currently running; 

2. on the scheduled queues awaiting allocation of a 
time-slice; 

3. on the swap wait queue 

4. dismissed (in limbo); the fork executed a BRS 9 and 
dismissed itself in order to activate a lower fork. 

The fork can be reactivated because the linking is kept 
Intact in the PFORK and PDOWN entries in PACT. 

5. terminated; e.g., the fork ran to completion, exe- 
cuted an ellegal instruction, the user logged-off, etc. 
Once terminated, the PACT is returned to the free 
PACT list. 

The function of the various PAC table entries Is shown In 
Figure 3. Detailed explanations for each word of the table 
entries are as follows 



PNEXT 

(Word 0) 



Next queue or next program on queue 
<0 — next program >0— next queue 



■^ 



Used in the queue chaining scheme. Three possibilities 
exist: 

a. If the fork defined by this PAC table is on a queue and 
PNEXT Is >0, this fork Is the lost on a partlculor queue, 
and PNEXT points to the next queue. 

b. If the fork is on a queue and PNEXT Is <0, It Is a 
pointer to the next PAC table on the queue. 

c. If the fork is not on a queue, or this is a dead PAC 
table, PNEXT is not meaningful. 

PL 

(Word 1) 



u 

M 





O 
V 


File No. of 
subr, file 





Saved (P) 



1 2 
UM 

OV 



3 8 9 10 23 

User Mode. This bit Is set If the fork executes 
In user mode. 



stored overflow — status of the hardwore over- 
flow Indicator Is stored Into this bit when ihe fork 
is dismissed. The overflow status can then be 
restored when the fork Is activated. 

Saved(P) the virtual (see chapter on "Mapping" in 
940 Reference Manual) address of the cell to which 
control must be transferred when the fork is reacti- 
vated. The following coding is executed when a 
fork is activated. 



LDA 
STA 

BRN* 



PL, 2 


n 



UM=1 



Scheduler 



PA 
(Word 2) 



Saved (A) 



23 



Saved (A) the contents of this cell will be placed 

in A when the fork is reactivated. The ceil is 
initialized from the A register if the fork was dis- 
missed or from the panic table if this is a new fork. 
"PB" and "PX" are stored in the user TS page, and 
are indexed by fork number (bits 18 through 20 
of PIM). 



RLl 
(Word 3) 



First pseudo-relabeling register 





RL2 
(Word 4) 



23 



Second pseudo-relabeling register 



23 



RLl and RL2 these are the pseudo-relabeling regis- 

ters for this fork. Each six-bit byte points to an 
entry in the SMT or user PMT which in turns points 
to a real page or RAD address. 



PPTR 

(Word 5) 



PDOWN 


PFORK 



11 12 

This word can have two configurations 



23 



a. If PAC table is not in use, bits 10 through 23 contain 
a pointer to the next free PAC table. 

b. If PAC table is in use, PPTR links this fork within the 
hierarchy of this user's forking structure. 

1, PDOWN points to the next lower fork, 

2, PFORK points to the parent fork. 

PTEST 

(Word 6) 






Activation 
condition 





Test word addrs., or interrupt 
number, or status of dead fork 



2 



8 9 



10 



23 



Mctivation conaltions are 
(Bits 3-8) 

Word greater than 

1 Word less than or equal to 



(Bits 3-8) 

2 

3 



Word greater than or equal to 

Word less than or equal to teletype early 

warning 

4 Special test. The address points to a special 
activation test routine. Applies to Phantom User. 

5 Interrupt occurred. The address contains the 
number of the interrupt which occurred. 

6 Word less than or equal to real-time clock. 

7 Special address - 

dead 

1 running 

2 BRS 31 (see Chapter 6 re BRSs) 

3 BRS 106 

4 Executive BRS 

5 BRS 109 

6 BRS 9 (User Program) 



10 
11 
12 

PQU 

(Word 7) 



Do not activate 

Bit 1 of word = (buffer ready) 

Word less than 



E 
X 


E 
X 
B 


QR 





PPAR 



12 3 



8 9 11 12 



23 



Program Quantum Word: 

EX fork has system status. 

EXB fork was created by an Executive BRS. 

QR contains the long quantum remaining for the 

fork (measured in 60 HZ clock ticks). 

PPAR PACPTR of o parallel fork. Parallel forks 

are not implemented. 

PTAB 
(Word 8) 



L 
M 


E 
X 

1 


T 
S 


Job No. 


— 



Panic Table Address 



12 3 



89 10 



23 



LM fork is locol memory. This means, essentially, 
that this fork will obtain memory independent of 
its ancestors which means, in turn, that its ances- 
tors are protected from this program. See "Mem- 
ory Acquisition. " 

EXl fork has subsystem status. 

TS a TS page has been assigned to ^he user in 

whose forking structure this PAC table appears. 

Job number has nothing to do with user or TT num- 

ber but is assigned arbitrarily when user logs on. 

Panic Table Address the virtual address of a 7-word 

panic table to be filled in when this fork terminates, 
usually within memory "owned" by the controlling fork. 



Program Activation Table 
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Next queue or next program on queue 

<0 — next program <0 — next queue 
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Saved (A) 
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First pseudo-relabeling register 






23 






Second pseudo-relabeling register 
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PDOWN 


PFORK or chain for free entries 
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Figure 3. PAC Table 
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01234 14151718 20 21 23 

Program Interrupt Mask: 

MT fork may acquire no memory. Any attempt to do 

so will result in the fork being terminated on mem- 
ory panic. See "Memory Acquisition". 



One Per Fork 

TP termination pending; set by the Phantom User if an 
escape occurs while NT is set. If the fork executes a 
BRS 47 (turn escape on), both the TP and NT bits are re- 
set. If the TP bit was set, the fork is dismissed onto 
QQE. The task for processing the escapes isstill on 
the Phantom Userand can nowbe processed. IfTPbit 
was not set, then the fork continues execution. 



NT 



off). The escape task is still oloced on the 



Program Activation Table 



Phantom User queue. However, Phantom User takes 
no action regarding termination of this fork. 

lEM software interrupt mask. See "Software 
Interrupts". 

XPB the fork number; used to index PB and PX in 

the TS page. This number may range between 
and 7, 

TO count of the number of time-out interrupts that 

the fork is currently using. A fork may have a 
maximum of 3 time-out interrupts armed. 

TIME-SLICING 

In order to implement time-slicing, the system defines a 
long and short quantum. These parameters are defined in 
clock-ticks and can be easily modified at system-generation 
time. All times in the discussion are measured in periods of 
the 60-cycle computer clock. Both TIME (short quantum) and 
TTIME (long quantum) are decremented at every clock tick. 
The clock interrupt routine isshown graphically In Figure 4. 

Once a fork is activated it will be allowed to execute until 
its short quantum has expired. The fork may take action 
that will cause itself to be dismissed (such as an I/O request) 
before the short quantum has elapsed. However, if the fork 
is compute bound, it will execute for at least one short 
quantum. 

When the short quantum has expired, a check is made to 
see if any forks that were dismissed for l/O ore ready to be 
activated. If no I/O bound forks ore ready, this current 
fork is again assigned a short quantum. This process con- 
tinues until the fork causes itself to be dismissed or the long 
quantum has elapsed. 

When the long quantum has elapsed, the fork is always dis- 
missed. This allows another compute bound fork to have a 
time slice. 

When a fork Is dismissed, the amount of long time quantum 
remaining is always stored into the PAC table. If a fork is 
dismissed for long-quantum overflow, it is assigned a new 
long quantum and this is stored into PACT. 

When a fork is activated, it is always assigned a full short 
quantum and the long quantum Is set from the value in PACT. 

The clock interrupt routine determines if any l/O bound 
forks are ready for activation by checking a word called 
ACTR. ACTR is set to -1 when the schedule determines 
that no I/O bound fork Is ready for activation. ACTR is 
incremented whenever any I/O bound fork is ready to be 
activated. 

Since the Monitor is not reentrant, no attempt to dismiss a 
fork is made if the system is executing in the Monitor mode. 
Therefore, no user fork is dismissed while executing a 
SYSPOP. If either the long or short quantum has elapsed, the 
clock interrupt routine arms the Monltor-to user transition 
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Figure 4. Clock Interrupt Routine 

trap. The trap occurs when the system transfers from the 
Monitor-to-user mode. This trap routine then checks 
whether the short quantum has expired while the system 
was in Monitor mode. If so, the fork Is dismissed to the 
appropriate queue. See the 940 reference manual for a 
discussion of the Monitor-to-user transition trap. 

SCHEDULED QUEUES 

When a fork has been dismissed or is awaiting activation, 
its PACT table will be on one of the four scheduled queues. 
The queues are listed In order of priority, 

QTI Forks dismissed for teletype input/ output 

QIO Forks dismissed for other I/O, forks that have 
just been initiated by a BRS 9, and forks ac- 
vated by escapes, program panic, etc. 



Time-Slicing 



QSQ Forks dismissed for short-quantum overflow. 

QQE Forks dismissed for long-quantum overflow. 

The information in any PAC table can be retrieved by using 
the PAC pointer associated with the PAC table. The PAC 
pointer is a negative index that allows retrieval of any entry 
in a fork's PAC table. Assume that PACPTR contains the 
index to a particular PAC table in the array of PAC tables. 
Then 



LDX 



PACPTR 



LDA PA, 2 Fetches the PA word 

LDA PQU, 2 Fetches the PQU word 

Location PACPTR always contains the PAC pointer of the 
fork the system is currently running. PA, PQU, PNEXT, 
etc., are defined in relation to the end of the PAC table 
array. Currently the system is dimensioned for 144 PAC 
tables. 

When a PAC table is on the scheduled queues, the PAC 
pointer for this fork is in the PNEXT word of the PAC table, 
immediately before it on the queue. The scheduled queues 
are each 3 entries long and have the following format: 



WordO 



Word 1 



Word I 



VkQ pointer to the first PAC table on this 
queue, or the address of the next queue 



23 



PAC pointer to the lost PAC table on this 
queue, or a pointer to this queue 



23 



Address of the next queue 







23 



The scheduler begins searching a queue by fetching Word 
of the queue. If this word contains a positive number, there 
are no entries on this queue since a PAC pointer is always 
negative. However, if word does contain a PAC pointer. 
It can easily obtain the PTEST word associated with the 
PAC table and determine if activation is possible. If acti- 
vation is not possible, the PNEXT word can be retrieved 
(since each PAC table on a queue points to the next one on 
the queue) and the next PAC table can be checked for acti- 
vation. If an entire queue has been searched and no octi- 
vatible fork is found, the scheduler will then search the 
next lower priority queue. If there are no forks to be acti- 
vated, the scheduler simply continues searching the 
queues. 
For example, assume PAC tables numbered: 



1, 3, 

2, 8 
15, 5 
None 







are on QTl 
are on QIO 
are on QSQ 
are on QQE 



The numbers are assigned for convenience In the following 
diagram (Figure 5). Note that If a queue has no entries, 
the first word contains a positive number which Is the ad- 
queue . 



A.^.. ^l fU, 



PHANTOM USER 

There are certain operations that the Monitor must perform 
for the users on the system. Some of these tasks ore 

1. Processing of a teletype ON interrupt 

2. Processing of escapes 

3. Processing of the software time-out interrupts 

4. Processing of teletype OFF interrupts 

5. Typing of certain error messages 

6. Testing of I/O devices for ready. 

Consider the processing of a teletype ON interrupt. This 
involves the assignement of a job number, initialization 
of various tables, assignment and initialization of the PAC 
table for the Executive fork, etc. It is not feasible to per- 
form all of these functions in the teletype ON interrupt 
routine. Therefore, the interrupt routine should simply 
honor the Interrupt and notify the Monitor to finish pro- 
cessing the task. 

Since many of the tasks are initiated by an interrupt, the 
Monitor must have a task queue where a function that It 
is to perform can be added. As the system performs a task 
it can remove It from the queue. However, In order to 
process these tasks, the Monitor must be allotted a time 
slice. 

It is the scheduler that decides which fork on the system 
to activate. What should be given priority — the process- 
ing of a teletype OFF Interrupt or the activation of a fork 
on QTI that was dismissed for teletype Input and is now 
ready? The problem of priority assignment for all users on 
the system Is handled by establishing the scheduled queues. 
Therefore, the Monitor can conveniently be assigned a 
time slice if it has a fork on the scheduled queues. When 
this fork is activated It could check the task queue and 
perform the various functions. This fork Is referred to as 
the Phantom User. The Phantom User runs In Monitor mode 
and requires no memory of its own. Its memory and relabel- 
ing are those of the Monitor. The Monitor task queue Is 
called the PUCT table. 

The PAC table for the Phantom User Is set up and put on 
QTI when the system is first initialized. The PTEST word 
contains an immediate activation condition. When the 
scheduler activates the Phantom User, It first checks a word 
called PUCTR (Phantom User Counter), PUCTR Is Incremented 
by every routine that adds a task to the PUCT queue (the 
Phantom User Task Table), If PUCTR=0 (no tasks), the 
Phantom User dismisses Itself onto QTI with o PTEST word 
that has an activation condition of 4. The Phantom User 
will be reactivated and again check the PUCT table when 
at least three seconds have elapsed. If less than three sec- 
onds have elapsed but PUCTR Is greater than zero, the 
Phantom User will be activated. 

If PUCTR l^ greater thnn 0, the Phantom User begins to 
search the PUCT table for a task to perform. Each task 
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Figure 5. Fork Searching Scheme 



the Phantom User can perform is given a code number. 
(See bits 3-8 of the second word of a PUCT entry). Each 
time an attempt is made to process a task the following 
occurs: 

1. A check is mode to determine if the task is ready to 
be processed. For instance, the Phantom User can do 
nothing about a time-out Interrupt until the appropriate 
amount of time has elopsed. If the task cannot be pro- 
cessed, the Phantom User continues to scan PUCT until 
it reaches the end of the queue. 

2. If the task can be processed, PUCTR is decremented. 
It then branches to the appropriate routine for perfor- 
ing the task. All of the routines return to where the 
Phantom User can continue to scan the PUCT table. 

Location PUBPTR points to the first task, PUEPTR to the 
last task on PUCT. When all the entries in PUCT hove 
been tested. Phantom User dismisses itself with an activa- 
tion code of 4. If the Phantom User was unable to process 
any of the tasks and no new tasks were added while it was 
active, it is dismissed onto QQE. Otherwise, it is dis- 
missed onto QTI. 

Whenever the Phantom User is dismissed, location ACTPU 
Is set negative. Any routine that adds a task to PUCT will 
increment ACTPU. The scheduler checks location ACTPU 
before searching the scheduled queues. If ACTPU is not 
negative, the Phantom User will be moved from GQE to 
QTI. 

Figure 6 shows the format for the PUCT table entries. 
A routine nomed EPU adds an entry to the PUCT list. 



EPU accepts its input parameters through the A, B, 
and X registers. 



SUMMARY OF SCHEDULER FUNCTIONS 

Figure 7 is a flow diagram showing the functions of the 
scheduler. The scheduler searches the scheduled queues 
for an activatable fork. When it finds one it calls the 
swapper. The input to the swapper is the pseudo-relabeling 
registers and a flag called MGTS5. MGTS5 is set to to 
indicate that the swapper is to build up an appropriate list 
of RAD commands and initiate the RAD I/O, but not wait 
until the RAD I/O is completed. The swapper returns to 
the scheduler the real (hardware) relabeling registers. 
Since MGTS5=0, the swapper does not at this time set the 
hardware relabeling. 

The scheduler then puts the fork onto the swap queue 
(SWQ). SWO consists of five tables. These contain the 
PAC pointer of the fork (SWQPAC), the number of pages 
(minus 1) that still remain to be read from the RAD 
(SWGPGC), and the three reel relabeling registers 
(SWQRL1, SWGRL2, and SWGRL3). The RAD logic will 
decrement the page count each time a page is brought in. 
The schedule determines if a fork on SWG is ready to be 
activated by checking the page count. When the count is 
negative, the fork is in core and ready to be run. 

The SWC is scanned at ACT for forks that are ready to run. 
If none is found, then the resident user (a user dismissed 
for quantum overflow) is run. If there is no resident user 
and no fork has yet completed its swao, then the system 

continues to scan SWO. If a fork has all the required 
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Figure 6. Phantom User Queue Entry 



pages, the entry is removed from SWO and the swapper is 
again called. This time A/GTS5=-1. The swapper verifies 
that all of the pages are in, i. e., no RAD errors have 
occurred, and sets the hardware relabeling. The fork is 
then activated. 

If a RAD error did occur, the fork is dismissed on QGE with 
an immediate activation in PTEST, and control passes to 
PACGOl. 

At PACOE, any fork which is dismissed for quantum over- 
flow will have its memory locked in core and its real rela- 
beling saved in RURRLl, RURRL2, and RURRL3. The mem- 
ory of the previous resident user, if any, is released at this 
time. Whenever there are no forks on SWC that are ready 
to run, the resident user is activated, thus using CPU time 
which would otherwise be wasted. Whenever the resident 



user is activated, he loses his identity as the resident user 
and will be the resident user again only if he is dismissed 
for quantum overflow. 

There can be a maximum of two forks on ?WQ. This is 
accomplished by the coding at PACGOl. A fork will be 
added to SWQ only if there is no resident user. If there 
is no resident user, the coding at ACT will continue to 
search SWQ until one of the forks can be activated and 
thus removed from SWQ. If the fork that was placed on 
SWO first is still not finished swooping, and the second 
fork has all of its memory (often the case with the Phan- 
tom User), then the second fork will be activated. Because 
it is possible for a user to change his relabeling while he is 
active and thus request the swapping of a ; age from the 
RAD, buffered swapping In release 2.0 never attempts to 
have three swaps In progress at once. 
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RU Resident User (dismissed for quantum overflow). 
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* This pass through the queues can easily be removed. 
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Figure 7. Overview of Scheduler 
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3. FORKING STRUCTURE 



JOBS 

The system refers to a currently active user as a "job". A 
job number is associated with every forking structure. If 
the system is dimensioned to handle 32 users, the job num- 
bers range from to 32, with the Phantom User always 
assigned job number 0. The job numbers are assigned in a 
somewhat random fashion. As a user logs on the system, he 
is assigned a job number that is currently not in use. When 
he logs off, his job number is returned to the free job list. 
The available |ob numbers are chained in the TTNO array. 

The job number is used to index several tables. These tables 
contain information that pertains to the job, rather than an 
individual fork, such as the teletype number associated with 
the user, CPU time, etc. The job number is stored into the 
PAC table for every fork in a user's structure. The job tables 
are shown in Figure 8. 



PMT AND SMT TABLES 

The PMT (Private Memory Table) preserves the environment 
of the user's memory. The table provides a real page num- 
ber and a RAD address and indicates whether the page is in 
core or on the RAD. Each user is assigned a PMT. The 
table is 20B entries in length which represents the 16 pages 
or 30 K and one TS page that a user can acquire. The PMT 
table that a user is assigned is a function of his job 
number. 

There is one SMT (Shared Memory Table) in the system. 
The SM.T is similar in format to the PMT. The SMT provides 
information about the Monitor, Executive, and reentrant 
subsystem pages. This table contains 60B entries. Each 
entry In the table is unique to a particular subsystem. The 
entries are assigned when the system is assembled, (See 
Figure 9. 

PSEUDO-RELABELiNG 

When a fork Is dismissed. It would be meaningless to save 
the contents of the hardware relabeling registers, since 
memory Is being changed dynamically. Therefore, each 
fork has a pair of "pseudo-relabeling" registers associated 
with It, Each pseudo-relabeling register consists of four 
bytes. Each byte points to a PMT/SMT entry. Using the 
PMT/ SMT tables, any necessary swapping can be Initiated 
and the hardware relabeling can be constructed, 

Psuedo-relabeling bytes with a value of through 57B point 
to SMT entries. Bytes having a value 60B through 77B point 
to a PMT entry. 

The Executive always uses PMT entry 60B for the TS page. 
All of the reentrant subsystems use at least one page of the 
user's memory for scratch storage. 



Ac r. Url r., 



k</ 



A" Instruction referencing a paqe that the fork does not have) 



a page is acquired and a RAD address is supplied. This 
process can continue until the user has acquired all 
32 K. 

In this way, the PMT reflects all the memory that a user 
has acquired. The pseudo-relabeling registers Indicate 
which PMT/SMT entries (i.e., what memory) are neces- 
sary in order to activate a particular fork. 



MEMORY ACQUISITION 

A fork may have a maximum of 16K. When the fork Is 
activated it may have less than 16K and then acquire 
more memory as needed while it Is executing. The follow- 
ing is a partial list of how not to acquire more memory), 

• By falling through a page (to a page which Is not In 
the pseudo-relabeling) to get the next Instruction, 

• By going Indirect via some address which Is out of 
bounds (i,e,, LDA *100 where 100 Is out of bounds), 

• By doing an EXU to an address which Is out of bounds. 

• By doing a POP If page is not In the fork's 
relabeling, 

• By an unconditional branch to an out of bounds address, 

• By doing a BRS 44 and requesting a byte that points to 
a PMT entry that has not been acquired. 

• By doing a BRS 9 and requesting pseudo-relabeling 
bytes that are not meaningful. 

The correct way to acquire more memory Is to execute any 
instruction (such as LDA, STA, ADD, MIN, etc) that 
directly references a location in a page that has not been 
acquired. This includes the Initial loading of a program or 
an I/O request into a page which has not been acquired. 

If the fork addresses a block of memory that Is not assigned 
to It, o check Is made to determine whether the machine 
size specified by the user has been exceeded. If so, a mem- 
ory panic Is generated. If the fork Is fixed memory, a mem- 
ory panic is also generated. Otherwise, a new block Is 
assigned to the fork so that the Illegal address becomes 
legal. For a local memory fork, a new block Is always 
assigned. Otherwise, the following algorithm is used: 

The number, n, of the relabeling byte for the block addressed 
by the Instruction causing the memory trap is determined. 
A scan is made upwards through the fork structure to (and 
Including) the first local memory fork. If all the forks 
encountered during this scan have Rn(the nth relabeling 
byte) equal to 0, a new entry is created in PMT for a new 

nlrirK n,T iicor rr»^mr»r\/ TUo ^rJrJrocc r\f fkic £^^¥r\/ ic i-.iif ',-»f^ 

Rn for all the forks encountered during the scan. 
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Figure 9. Private Memory Table Entry or 
Shared Memory Table Entry 

If a fork with nonzero Rn is encountered its Rn is transmitted 
down to all the forks between it and the fork causing the 
trap. If any fixed memory fork is encountered before o 
nonzero Rn is found, a memory panic occurs. 

This arrangement permits a fork to be started with less mem- 
ory than its controlling fork in order to minimize the amount 
of swapping required during its execution. If the fork later 
proves to require more memory, it can be reassigned the 
memory of the controlling fork in a natural way. If is, of 
course, possible to use this machinery in other ways, for 
instance, to permit the user to acquire more than 16K of 
memory and to run different forks with nonoverlapping or 
almost nonoverlapping memory. 

The acquisition of memory is performed in a routine named 
MGET, The RAD bit map is checked and an available page 
is found. The RAD address is stored into the next available 
PMT entry and the swapper is called. The swapper then 
finds an available core page. MGET calls the swapper with 
MGTS5=-1. The swapper waits until any necessary RAD 
I/O has been completed and sets the new hardware relabel- 
ing. See Chapter 4 for more information on memory 
allocation. 

CHANGING RELABELING 

Several BRS s are available to the user to allow him to manip- 
ulate his pseudo-relabeling. 

BRS 43 Returns the pseudo-relabeling of the calling 

fork in A and B 

BRS 44 Sets the pseudo-relabeling with the contents 

of A and B. There are several restrictions 
associated with this BRS: 

1. The user cannot relabel over a system 
page unless he has the proper status. 

2. The user cannot specify a pseudo- 
relabeling byte that points to a PMT 
entry that he has not acquired. 



When a fork is activated, all the pseudo-relabeling bytes 
are satisfied. Depending on the execution path, the fork 
may not actually need all of the pages. The fork can 
release a page by replacing the desired byte with 0. This 
will reduce the amount of swapping necessary each time the 
fork is activated. The BRS 44 does not remove the entry 
from the PMT. Therefore, the page can be retrieved by exe- 
cuting the BRS 44 and specifying the byte. 

For example, assume a fork consists of five pages. All of 
the error routines ore in one page. This page can be rela- 
beled out when the fork begins execution. When an error 
occurs, the page can be relabeled in and a branch made to 
the appropriate error routine. 

It is possible for one fork to acquire all 30K of memory. 
However, it must use the BRS 44 to relabel some of the pages 
out, since a fork can have only 16K of memory active at any 
one time. 

CREATING A LOWER FORK 

The forking structure consists of up to 8 forks including the 
Executive fork. The forking structure provides the follow- 
ing advantages: 

• Swapping time con be significantly reduced by seg- 
menting a program. 

• It permits centralized control. The user can activate 
one of the subsystems, return to the Executive to have 
various functions performed, return again to the sub- 
system, call another subsystem, etc. 

BRS 9 will initiate and activate a lower fork, taking its 
argument from the A register. The first six bits of the A 
register specify various attributes the lower fork should 
have while the remaining bits specify the address of a 
7-word panic table. 

The panic table allows the parent fork to transfer various 
parameters to the lower fork. When the lower fork termin- 
ates, information is returned to the parent via this table. 
A panic table must not overlap a page boundary or be used 
for more than one dependent fork. 

Table 1 . Panic Table 



Word 


Contents 





Program counter 


1 


A register 


2 


B register 


3 


X register 


4 


First relabeling register 


5 


Second relabeling register 


6 


Status 



Creating a Lower Fork 



13 



The status word is set by the system and may be: 
-2 Dismissed for input/ output 

-1 Running 

Dismissed on escope or BRS 10 

1 Dismissed on illegal instruction panic 

2 Dismissed on memory panic 

Table 2. Significance of Bits in A Register 



Bit 



Significance 



Make fork system if current fork is system 

Set fork relabeling from panic table. Otherwise, 
use current relabeling. 

Propagate escape assignment to fork (see BRS90). 

Make fork fixed memory. It is not allowed to 
obtain any more memory than it is started with. 

Make fork local memory. New memory will be 
assigned to it independently of the controlling 
fork. 

Make fork subsystem status if current fork is 
subsystem. 



BRS 9 causes the following to occur: 

1. A PACT is obtained and Initialized. The PA and PL 
words are set from the panic table entries. Various 
other bits in the PAC table are set from the informa- 
tion supplied in A. RLl and RL2 are set up from the 
contents of the panic table or from the relabeling 
registers of the currently running fork. Linkage to the 
parent fork is established by setting the PFORK and 
panic table address entries. The PDOWN parameter is 
set in the PAC table of the parent fork. 

2. A fork number is obtained. A job may hove o maximum 
of 8 forks, including the Executive fork. The values 
for B and X that are supplied in the panic table are 
stored into the TS page indexed by fork number. 

3. The supplied pseudo-relabel ing is checked for validity. 
The bytes must point to PMT entries that have been 
acquired, a user fork cannot relabel in system pages, etc. 

4. A word called TTYASG (indexed by teletype number) 
contains the PAC pointer of the fork that is to be ter- 
minated when an escape occurs. The fork pointed to by 
TTYASG and all lower forks will then be terminated. 
BRS 9 will set TTYASG to the PACPTR of the fork it is 
creating unless bit 2 of A is 0. 

5. The lower fork (the one being created by BRS 9) is put 
on QIO with an immediate activation condition. 



6. The parent fork is now dismissed (i, e. , placed "in limbo" 
which implies that the fork is not on a scheduled queue) 
with an activation condition of 7 ^ 6. If the parent 
fork has Executive status it is not dismissed but contin- 
ues execution af the instruction following BRS 9. 

The parent fork will be reactivated when the lower fork 
"panics". If the fork has Executive status it will continue 
to run after the execution of BRS 9. The parent fork and 
lower forks may interact in the following 3 ways: 

1. If the parent fork is not dismissed by BRS 9: 

BRS 30 reads the current status of a lower fork into 
the panic table. It does not influence the 
operation of the fork in any way. 

BRS 31 causes the controlling fork to be dismissed 
until the lower fork causes a panic. When 
it does, the controlling fork is reactivated 
at the instruction following BRS 31, and the 
panic table contains the status of the 
fork on its dismissal. The status is also put 
in X. 

BRS 32 causes a lower fork to be unconditionally 

terminated and its status to be read into the 
panic table, 

BRS 106 causes the controlling fork to be dismissed 
until any subsidiary fork causes a panic. 
When it does, the controlling fork is reac- 
tivated at the following instruction with 
the panic table address in A, and the panic 
table contains the status of the fork at its 
dismissal. 

BRS 107 causes BRS 30 to be executed for all subsid- 
iary forks. 

BRS 108 causes BRS 32 to be executed for all subsid- 

inrv forKs^ 

2. If interrupt 3 is armed in the controlling fork, the ter- 
mination of any subsidiary fork will cause that interrupt 
to occur. The Interrupt takes precedence over a BRS 31. 
If the Interrupt occurs and control Is returned to BRS 31 
after processing the interrupt, the fork will be dis- 
missed until the subsidiary fork specified by the restored 
(A) terminates. 

3. The forks can share memory. The creating fork, can, 
as already Indicated, set the memory of the subsidiary 
fork when the latter is started. 



PANIC CONDITIONS 

The three kinds of panic conditions that may cause a fork to 
be terminated are listed in the description of the status 
word. If the panic was caused by an escape, the follow- 
ing occurs to the fork being pointed to by TTYASG, and to 

all lower forks. 
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Panic Conditions 



1. The page in the parent fork that contains the panic 
table is brought into core if necessary. Data is inserted 
into the panic table, 

2. The B and X registers are stored into the TS page, 

3. The PAC table is returned to the free PACT list. The 
only exception is that the PAC table of the Executive 
is not released by any panic condition. If the panic 
was not caused by an escape, the above three steps will 
affect the fork causing the panic. 

The PAC tabi e of the control I ing fork (or the fork above the one 
being pointed to by TTYASG) is put onto QIO with an immedi- 
ate activation condition. If TTYASG contains the Executive 
PACT pointer then the Executive fork is placed on QIO. When 
the controlling fork is activated, execution will begin at the 
location indicated by PL. For user forks this will be one instruc- 
tion after BRS 9, (BRSs are explained in Chapter 6.) 

The panic that returns a status word of is called a fork 
panic and may be caused by either of two conditions: 

1. The escape button on the controlling teletype is 

pushed, or an off interrupt occurs. This terminates a 
fork with a fork panic, A fork may declare that it is 
the one to be terminated by executing BRS 90. If a 
user fork is terminated by escape, the teletype input 
buffer is cleared. If the controlling fork of the ter- 
minated fork is executive, the output buffer is also 
cleared. 

If a fork to be terminated by escape has armed inter- 
rupt 1, the interruptwill occur instead of a termination. 
The teletype buffers will not be affected. 

If the Executive is activated, control goes to the loca- 
tion EXECP in the Executive. Executive programs can 
turn the escape button off with BRS 46 and turn it back 
on with BRS 47. An escape occuring in the meantime 
will be honored when BRS 47 is executed, A pro- 
gram which is running with escape turned off is said 
to be nonterminable. BRS 26 skips if there is an escape 
pending. 



If two escapes occur within approximately 0, 12 seconds, 
the Executive fork will be activated. This has the 
same effect as having TTYASG contain the Executive 
PACT pointer. This device permits a user trapped in 
two malfunctioning lower forks to escape. Closely 
spaced escapes can be conveniently generated with 
the repeat button on the teletype. 

2. A BRS 10 can be executed in the lower fork. This 
condition can be distinguished from a panic caused 
by the escape button by the fact that, in the former 
case, the program counter in the panic table points 
to a word containing BRS 10, 

An extension of this system provides a way in which sev- 
eral forks may be terminated simultaneously by a lower 
fork, BRS 73 provides a count in the A register, A scan 
is made upward through the fork structure, decrementing 
this count by one each time a fork is passed. When the 
count goes to 0, the scan is terminated and all forks 
counted are terminated. If an executive program is 
reached before the count Is 0, then all the user programs 
below it are terminated. 

The panic which returns a status word of 1 is caused by the 
execution of an illegal instruction in the fork. There are 
two kinds of illegal instructions: 

1, Privileged machine instructions. 

2. SYSPOSs, either forbidden to the user, or provided with 
unacceptable arguments, 

A status word of 2 is returned by a memory panic. This 
may be caused by an attempt to address more memory 
than is permitted by the machine size the user has set, 
or by an attempt to store into a read-only page. If inter- 
rupt 2 is armed, it will occur instead of the memory 
panic. 

Note that no type of panic releases memory. The PMT 
entries remain intact. Therefore, the forking structure 
can be conveniently recreated after the panic. 



Panic Conditions 
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4. SWAPPER, MEMORY ALLOCATION AND RAD ORGANIZATION 



SWAPPER 

The swapper accomplishes the allocation of memory. It is 
called to activate a fork, change relabeling, or acquire a 
page of memory. The input to the swapper is the pseudo- 
relabeling. To determine the exact location of each of the 
pages the fork requires, the pseudo-relabeling Is decoded 
and the SA/T and PMT tables are consulted. The swapper 
can then determine how many pages need to be read in from 
the RAD. This count in then compared with the Memory 
Availability Count (MAC). MAC contains the number of 
unlocked pages (minus one). 

The system keeps tables that define the status of real mem- 
ory. These tobies, both indexed by real page number, are 
the Real Memory Table (RMT) and Real Memory lock Count 
(RMC). The RMC entry indicates whether a page is locked 
or unlocked. If RMC = -1, the page is unlocked and avail- 
able for swapping. An RMC entry may be mode non- 
negative (the page can be locked) for any of the follow- 
ing reasons: 

1. Port of the Monitor is in the page. 

2. The resident user occupies the page. 

3. The page is I/O bound. This implies that the page 
contains an I/O buffer that is currently active. Pages 
which are being swapped are also I/O bound. Any rou- 
tine that initiates an I/O operation will increment the 
appropriate RMC entry. The I/O interrupt routine will 
decrement the RMC entry when the operation has been 
completed. 

4. The scheduler locks the pages of a fork that is on SWQ 
so that the memory will not be assigned to the second 
fork that could be placed on SWQ. The memory is 
unlocked when the fork is activoted 

If the number of pages a fork requires is greater than MAC, 
the swapper is unable to allocate memory at this time and 
exits with on abnormal return. 

If sufficient memory is available, the pages to be swapped 
are selected. The RMT table is scanned to determine the 
optimum pages to be swapped. The format of RMT is shown 
in Figure 1 

At most, three passes are made through the RMT tables to 
select the required number of pages. The following method 
is used to determine which pages are to be released: 

1. No locked page (see RMC) is released. 

2. Pages that are not locked are selected in the following 
manner: 

a. User pages (PMT pages) marked as read-only 
(RMT bit 1 = 1, bit 2 - 0). No RAD write is 
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Address of SMT/PMT 
responsible for this page 






1 2 4 8 9 10 23 

USE The page is in use. Th6 setting of this bit 

indicates to the swapper that a RAD write must be 
performed before this page can be allocated. 

RO The page is marked as Read Only in the hard- 
ware relabeling registers. 

SMT This page is an SMT page. 

SWQ This page is being brought off the RAD at 
this instant in time by a fork which is on swap 
queue. 

4-8 Meaningful only if bit 3 is a 1. If so, this is 
a pointer to the entry on the swap queue which 
is responsible for this page. 

10-23 Core address of the SMT/PMT entry which 
is responsible for this page. 



Figure 10. Format of Real Memory Table (RMT) 

required in this case since there is a valid copy 
of the page on the RAD. 

b. User pages that are not read-only (RMT bit 1 = 0, 
bit 2 = 0). Requires RAD write-out. 

c. SMT pages (RMT bit 2 = 1). 

This scheme provides the SMT pages, which are the most 
likely to be used within the next few activations, with the 
best chance of remaining in core. 

The system has two methods for distinguishing PMT entries 
from SMT entries. The first is to use a system parameter 
called NCMEM (which is currently 60B): pseudo-relabeling 
bytes between 1 and NCMEM- 1 (57B) refer to the SMT; 
bytes equal to or greater than NCMEM point to the user's 
PMT; a relabeling byte of zero indicates that the page is 
not in use. The second method is to inspect the RO bit 
(bit 18). If the bit is one, the entry is SMT. 

Memory is allocated and a list of RAD operations is con- 
structed. After the required write commands have been 
constructed, all the read and write commands are placed 
on the RAD command list. When a RAD read is put on 
the list, the actual (real) memory address of the page is 
placed into the low order five bits of the PMT or SMT 
entry. Pages that have been selected to be released 
are marked in the RMT entry as being on the RAD. 
When all the commands have been placed on the RAD 
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queue, the RAD driver is called. Figure 11 shows the 
format of the RAD queue: 



Word 



RAD address 




Word 1 



23 
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Word Count 


Low Order Core Address 





Word 2 
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1 1 1 
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High 
core 
Add 


High 
Orller 
word 
count 



123 89 10 11 12 13 14 15 16 17 18 19 23 

Word 3 



Check 
Routine 



23 

Ell II (Zero Word Count) Interrupt armed. Used 

only for read commands 

WR Write Commands, 

EOD Operation code for EOD Instruction {06b) 

Word 2 See format for EOD instruction 



Figure 11. RAD Queue Entry 

If the swapper was called in the process of activating a 
fork (MGTS5 = 0; see Function of the Scheduler), certain 
parameters must be set to indicate that the fork is being 
placed on swap queue. As each RAD read command is 
added to the queue of RAD commands, a pointer to the swap 
queue is inserted in bits 3 through 8 of the appropriate RMT 
entry. Since MGTS5 = 0, the swapper does not wait for 
the completion of the RAD I/O. Now, all the SMT or PMT 
entries in the current pseudo-relabeling are examined and 
a set of real relabeling registers is constructed. The real 
relabeling registers are saved in the current input position 
of SWQRLl, SWQRL2, and SWQRL3 and are used to lock 
the fork's memory in core until it is activated. 

Bit 1 of RMT indicates a read-only page. This bit is set for 
all pages being read from the RAD. The bit is set in the 
OMR routine which sets up the read commands. When the 
user's real relabeling Is constructed In PKRL, all pages are 
marked as read-only. As the relabeling Is being prepared 
for output in LABEL, the TS page is marked as not-read- 
only to facilitate the handling of the read-only trap. 
As the user runs, any attempt to store into a user page 
results in a read-only trap and the code at TRAPR de- 
termines whether the page referenced Is a true read-only 



page or not. If the page is not a true read-only page, 
then bit 1 of the RMT entry is cleared, and the user's rela- 
beling is changed so that the page is no longer read-only. 

If a running fork calls the swapper to change its relabeling 
(or acquire more memory), a similar path is taken with the 
following exceptions: the swapper waits until the RAD I/O 
is completed; and the real relabeling registers are con- 
structed and stored in the fixed Monitor locations RRLl, 
RRL2, and RRL3 and output to the hardware relabeling 
registers. 

When the scheduler attempts to activate a fork that is on 
the swap queue, it calls the swapper with MGTS5 = -1. 
When the swapper examines the pseudo-relabeling. It 
should find all of the required pages in core and set the 
hardware relabeling. If this is not the case, a RAD error 
has occurred and the swapper will take an abnormal return. 
The fork will be dismissed on QOE with an immediate acti- 
vation condition. 

MEMORY ALLOCATION 

The method of memory acquisition Is described in Chapter 3, 
Pages can be completely released by use of BRS 4 or BRS 
121. BRS 4 requires an address (virtual) in A, BRS 121 
requires a relabeling byte. When the BRS is executed, the 
PMT entry for the page is cleared, the pseudo-relabeling 
bytes are zeroed for all forks in the structures, and the RAD 
map is adjusted to indicate the availability of the page. 
A page released in this manner is Irrecoverable. A user 
cannot use these BRSs to release an SMT page or his TS 
page. (See EX bit in PMT/SMT). 

BRSs that are restricted to Executive forks include: 

116 Read relabeling from user's TS page 

1 17 Set relabeling In user's TS page 

120 Obtain a page 

56 Make page Executive (see EX bit In the PMT) 

104 Read page from the RAD 

105 Write a page on the RAD. 

RAD ORGANIZATION 

RAD space is allocated at the rate of one page (2K words) 
at a time when requested. A bit map, DRAT, with one bit 
for each page on the RAD, Is used to determine which 
pages are available. When a user requests a page of mem- 
ory, the code at PMTA assigns a space on the RAD for the 
new page so that the user's pages will be rotationally con- 
secutive In their order of occurrence In his PMT. This means 
that, although two pages which are consecutive in the PMT 
may be quite far apart on the RAD, they may be read In with 
no rotational delay between them. The job number of the 
user determines whether the first page of the user's memory 
Is assigned an even or an odd position on the RAD. When 
a user releases a page of memory, the code at MPUT3 
returns the appropriate bit to the bit mnn. The first 64 pages 
of the RAD contain the subsystems and Executive. 
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5. SOFTWARE INTERRUPTS 



A facility is provided in the Monitor to simulate hardware 
interrupts. There are eleven possible interrupts, five are 
reserved for special purposes and six are available to the 
programmer for general use. A fork may arm the interrupts 
by executing a BRS 78 with an 1 1-bit mask in the A register. 
This causes the appropriate bits in PIM to be set or cleared 
to correspond to the bits in the mask. Bit 4 of A corresponds 
to interrupt number 1, etc. No other action is taken at this 
time. When an interrupt occurs the execution of an +SBRM* 
to location 200 plus the interrupt number is simulated in the 
fork that armed the interrupt. 

Note: The program counter stored in this case is the loca- 
tion of the instruction being executed by the inter- 
rupted fork, not the location in the fork which 
causes the interrupt. The proper return from an 
interrupt is a BRU to the location from which the 
interrupt occurred. This will cause the proper 
return in all cases, including interrupts from input/ 
output instructions. 

INTERRUPTS 5 THROUGH 10 

A fork may generate an interrupt by executing a BRS79 with 
the number of the desired interrupt in the A register. This 
number may not be one, two, three, four, or eleven. The 
fork that arms the interrupt should not be the one that trig- 
gers it using the BRS 79 (i.e., a fork should not interrupt 
itself using the BRS 79. The interrupt causes the fork struc- 
ture to be scanned upward. The first fork with the appropri- 
ate interrupt mask bit set is interrupted. The interrupted fork 
is put on QIO with an activation condition of 5 ^^ interrupt 
number. Execution of the program in the fork causing the 
interrupt continues without disturbance. If no interruptable 
fork is found, the Interrupt Instruction is treated as a NOP. 
If there is an interruptable fork, it skips on return. 



SYSTEM INTERRUPTS 

Interrupts 1, 2, 3, 4 and 1 1 are the system Interrupts. They 
can be caused by the same fork which has the Interrupt 
armed. 

If the fork which Is being pointed to by TTYASG also has 
Interrupt 1 armed, a program panic (BRS 10 or escape key) 
that would normally terminate the forking structure, will 
Instead cause interrupt 1 to occur. The fork will be placed 
on GIO and begins execution at the location Indicated by 



the contents of location 201 B. This permits the programmer 
to control the action taken when the escape key is pushed 
without establishing a fork, specifically for this purpose. 
If depressing the escape key causes an interrupt to occur 
rather than terminating a fork, the input buffer will not be 
cleared. 

If a memory panic occurs in a fork that has armed Interrupt 
2, it will cause interrupt 2 to occur rather than terminating 
the fork. If an Illegal instruction panic occurs in an exec- 
utive fork that has armed interrupt 2, it will cause interrupt 
2 to occur rather than terminating the fork. 

Interrupt 3 is caused, if armed, when any lower fork ter- 
minates. Interrupt 4 is caused, if armed, when any Input/ 
output condition occurs that sets a flag bit (e.g., end of 
record, end of file and error conditions). 

Interrupt 1 1 is caused, if armed. If a disc error Is encoun- 
tered during a BRS BE + 1 or BRS BE + 2. These BRSs require 
system status. Consequently, Interrupt 1 1 has no meaning 
for user or subsystem forks. 

Whenever any Interrupt occurs, the corresponding bit in the 
interrupt mask is cleared and must be set explicitly If It Is 
desired to keep the interrupt on. Note that there is no restric- 
tion on the number of forks which may have an interrupt on. 

To read the Interrupt mask Into A, the program may execute 
a BRS 49. 



TIME-OUT INTERRUPTS 

A fork may be Interrupted after a specified period of time 
by Issuing BRS BE + 12. It takes the Interrupt mask In A, 
the time (In msec) in B, and the Interrupt number In X. If 
the specified Interrupt Is arrned when the time runs out, the 
fork will be Interrupted. 

The interrupt number which is specified In X may be any of 
the user Interrupts (5 through 10). A fork may have a max- 
imum of 3 time-out interrupts pending. The number of time- 
out interrupts that are pending Is noted In the TO entry of 
the PAC table. 

+ SBRM* When a fork Is being activated because of a 

software interrupt, the scheduler simulates the execution of 
a BRM* 200B+N where N Is the interrupt number. See des- 
cription of BRS 79. 
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6. BRS LOGIC 



The BRSs are divided into classes 1, 2, and 3, The class of 
each BRS is listed in Appendix B, See Appendix K for flow 
chart of BRS logic. 

The class 3 BRSs (also called executive BRSs) all declare a 
lower fork to execute. This fork runs in user mode. Many of the 
BRSs that deal with file manipulation are in this category. 

The Monitor provides a number of BRSs which provide ser- 
vices for the user. Many of these are incorporated in the 
string processing system or in the floating point package 
and are described later. These are called class 2 BRSs. 

When a BRS is executed, flow enters the BRS file at loca- 
tion BS. Absolute location zero contains: 
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LOG 



12 3 8 9 10 23 

U BRS executed in user mode 

OV Status of overflow indicator 

LOG Location of the BRS instruction. This will be 

a virtual address if BRS was executed in the 
user mode. 

The contents of the central registers are stored into SSOl, 
SS02, and SS03. 

The number of the BRS can be obtained by referencing loca- 
tion 0. The transfer vectors for the BRSs are stored at BST 
through BSTU, Location BSX Is set to contain the transfer 
vector. The transfer vector will be: 



BSX = 



BRU 



ROUTl for a Glass 1 BRS 






EAX 


ROUT2 


for a Glass 2 BRS 


NOP 


N 


for a Glass 3 BRS 


BRM 


TRAPB 


for an unlmplemented or 
nonexistent BRS 



Flow is transferred to a class 1 BRS when the system executes 
an EXU BSX. Real location will contain its initial setting 
while the BRS is executing. A class 1 BRS returns to the 
calling program by branching to the POPX routine. POPX 
will restore the central registers and execute a BRR 0. If 
the BRS gives a skipping (exception) return It will Increment 
location before branching to POPX. 

While a class 2 or 3 BRS Is executing, location SBRSRT 
contains the Initial setting of location 0. Flow Is trans- 
ferred to a class 2 BRS when the system executes a BRU* BSX. 

The BRS returns to the calling program by branching to the 
EPOPX routine. EPOPX executes a BRR SBRSRT. 

The value N in the transfer vector of a class 3 BRS Indicates 
what pseudo-relabeling the BRS fork should have and pro- 
vides information for setting the fork's PL word, A PAG 
table Is obtained and initialized. The pseudo-relabeling 
Includes the TS page, the GOMPG file, and either the 
GSBR or the FLTIO file. The PL word Is Initialized to begin 
execution at a jump table in either GSBR or FLTIO. The 
contents of location are stored Into UPL, The BRS fork 
is put on OIO. The parent fork Is dismissed (put in limbo) 
with an activation condition of 7 « 4, 

The BRS fork will execute a BRSlll when it has finished 
executing. The BRS 111 will delete the BRS fork's PAG 
table. The contents of location UPL are stored into location 
0. The swapper is called to relabel In the parent fork. A 
branch Is then made to POPX. 
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7. INITIALIZATION AND TERMINATION OF A USER 



INITIALIZATION OF A USER 

When the user dials on the system, the "teletype on" 
interrupt is generated. The interrupt routine places a task 
on the phantom user. The phantom user will process the 
task when four seconds (from the time the interrupt was 
sensed) have elapsed. This delay in processing allows time 
for the teletype carrier signal to become stable. 



The major part of the coding for this phantom user task is 
performed in a routine named TSON. TSON assignes a job 
number to the user and acquires a PAC table for the Execu- 
tive fork provided there is a job number and a PAC table 
available. The PAC table is Initialized to contain the 
pseudo-relabeling and status parameters applicable to an 
Executive fork. The PL word is initialized to begin exe- 
cution in the TSONI routine. (TSONI is a monitor rou- 
tine.) The PMT table that corresponds to this job and the 
WERIS entry for the teletype are zeroed, and TTYASG is 
initialized to contain the PAC pointer of the Executive 
fork. The PAC table is then added to the QTI queue. 

When this fork is allotted a time slice, execution begins at 
TSONI. A TS page is acquired and relabeled into logi- 
cal page zero of the Executive relabeling and logical 
page seven of the monitor relabeling. The Executive 
subroutine transfer vectors and other constants In the TS 
page are initialized, A branch Is then taken to a location 
in the Executive, causing a transfer to the user mode. The 
Executive then attempts to log the user onto the system. If 
the user does not successfully log on within 90 seconds, his 
teletype Is deactivated and the Executive fork is 
terminated. 



TERMINATION OF A USER 

A user can indicate the termination of his job by giving the 
LOGOUT or EXIT command, or by hanging up the teletype. 
The LOGOUT command releases all the program memory (clears 
PMT entries 61 B through 77B), writes the user's file directory, 
outputs accounting information the system requires for billing, 
prints an elapsed time message to the user, closes all files, 
and releases the TS page. The Executive then executes a BRS 
1 12 which resets such tables as WERIS, TTYASG, LCW (used 
for linking), releases the PAC table for the Executive fork, 
removes any tasks from the phantom user that apply to this 
teletype, and deactivates the teletype if the operator has 
issued the SHUT DOWN command. The BRS 1 12 then causes 
the same task as that which results from a "teletype on" inter- 
rupt to be added to the phantom user's task queue. This allows 
another user on the same teletype to log onto the system pro- 
vided that the first user did not hang up. 

The EXIT command is similar to LOGOUT except that the 
user's file directory is not written. Therefore, any user 
files established during this session are not entered into his 
directory. 

The "teletype off" Interrupt places on the phantom user a 
task that Is similar to the processing of a high speed escape. 
With the exception of the Executive fork, the entire forking 
structure is terminated. The teletype Input and output buf- 
fers are cleared and the Executive fork is placed on QIO 
with the PL word containing OFFINT (OFFINT is a location 
in the Executive), At OFFINT a dump file of the user's 
memory is taken If the user has established a /S/ file and 
has not logged off the system. The path taken now is the 
same as if the user had given the LOGOUT command. That 
Is, the memory is released, file directory written, etc, and 
finally the BRS 1 12 is executed. . 
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8. TELETYPE INPUT/OUTP.U.T 



TELETYPE BUFFER 

Monitor file TTY contains the teletype buffers, pointers, 
and tables. (See Figure 12.) Each teletype has one buffer 
which is 30 words in length. The label on this buffer is 
TTYBUF. TTYBUF is initialized in TTYSET. 



TTYBUF 



30 Words 



-30 



> 4 



-30 



Buffer for 
Teletype 



Dummy Word that indi- 
cates end of Buffer 

Buffer for 
Teletype 1 



Buffer for 
Teletype n 



The teletype buffers are "ring buffers". Pointers indicate 
where the next character is to be read into (or taken out of) 
the buffer. Assume a character for TTY has just been put 
into TTYBUF + 29. When the next character comes in, the 
dummy word will be detected, the Input pointer will be 
adjusted by the value of the dummy word (-30), and the 
character will be placed into location TTYBUF. 

The format for each word in TTYBUF is: 



Input Char 


Output Char 


Echo Char 
or Zero 







78 



1516 



23 



When a character is typed on a teletype, it is converted to 
940 internal code and added to the input buffer. The echo 
character is in trimmed ASCII. The output character is 
formed by adding 240B to the internal code. 

Although the input and output buffers shore the same loca- 
tions, separate pointers allow the buffers to be manipulated 
independently of each other. Teletype associated variables 
are shown in Figure 12. 



OUTPUT PATH 

To output a character from location M, the SYSPOP 

TCO M (teletype character output) 

is used. This instruction outputs a character from the 



rightmost eight bits of location M. Normally, the character 
is in internal format. 

If the user executes a TCO instruction, TOSS is incremented. 
The character is placed in the location pointed to by TOS5. 
If this is the first character that is being sent out (TOSS Is 
negative) the output interrupt must be initiated. This is 
accomplished by "potting" out 001400CN where CN is the 
teletype number. The setting of bits 8 and 9 will trigger 
the interrupt. The character count in TOS2 is also 
incremented. 

The interrupt routine will increment TOS4, decrement TOS2, 
and output a character from the location pointed to by TOS4. 

A fork will not be dismissed for teletype output unless the 
buffer is full (i.e., TOS2 = 30). When the buffer is full, 
the fork is dismissed with an activation condition of 3 ('^ 
TOS2 + CN. The fork will be reactivated when TOS2 is 
less than or equal to the teletype early warning (TTYEWM) 
— a system parameter with the value 6. 

If a fork wishes to send out a multiple number of spaces, a 
135B (the multiple blank character) is sent. The next char- 
acter that is sent represents the number of blanks to be out- 
put. The TOS3 indicator keeps track of the detection of 
the 135B and the outputting of the blanks. 

The output interrupt will respond with both a carriage re- 
turn and a line feed if either character Is detected. 



ECHO TABLES 

The teletypes used are fully duplexed to allow simultaneous 
keyboard transmission and reception. That is, when the 
user types a character, no printing occurs. As Illustrated 
below, the character is transmitted to the 940 and the 
software echoes It bock (prints the character). Four echo 
tables are available. Presently the system may choose to 
print or not to print a character (echo or not). 



940 



TTY 
Printer 



Send Echo 



TTY 
Keyboard 



Send Character 



Look up 
character in 
echo table 



The way the echo table logic is Implemented, It would be 
possible to modify an echo table so that when an A Is typed 
a Z is echoed. The input character serves only as a pointer 
Into the echo table. The corresponding table entry is then 
output to the teletype. 

In addition to specifying the echo character, the echo tables 
also define the "break" characters. A fork will not be dis- 
missed for teletype input unless the input buffer Is empty. 
However, once the fork Is dismissed, it will be reactivated 
again when a break character has been input or the buffer 
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TOS2 
TOS4 

TOS5 

TO S3 

TIIS5 

ATIS2 

ATIS5 
ATIS4 

TIS2 

TIS4 

TIS5 

TTYTBL 



Number of characters in output buffer; has the value -1 when output buffer is inactive. 

Output readout pointer. The output interrupt routine outputs a character from the location indicated by 
TOS4. 

Output write-in pointer. Pointer to next available space in the output buffer, e.g. the TCO routine will 
place a character in the location indicated by TOS5. 

— not in multiple blank mode; 20000000B -just received 135 (multiple blank character); other -number 
of blanks to be output. This is used to simulate the tab settings on a typewriter. 

if last character output was not a carriage return (CR) or line feed (LF) 

CR or LF character and bit 23 set when software has sent a CR 

CR or LF character and bit 23 reset when software has sent an LF. 

Number of "pinned" words in ATTBUF, This location is incremented by the input interrupt routine and 
decremented by the 205 interrupt routine. 

Write-in pointer. The input interrupt routine will put a word into the location pointed to by ATIS5. 

Read-out pointer used by the 205 routine. A word is pulled out of ATTBUF from the location pointed to 
by ATIS4. 

Number of characters in the input buffer. This word is incremented by the 205 routine and decremented 
by any routine requesting teletype input (such as TCI). 

Write-in pointer used by the 205 routine. A character is pulled out of ATTBUF and put into TTYBUF in 
the location pointed to by TIS4, 

Read-out pointer used by any routine requesting teletype input (such as TCI). A character is read out of 
TTYBUF from the location pointed to by TIS5. 



N 
S 


B 

K 


X 
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s 

I 


s 
o 


X 

N 


L 

I 


P 


A 

I 


A 
M 


ADDR or TC 



1 23456789 10 
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NS Not 8-level mode 

BK Waiting for a break character 

XO Paper tape reader is to be turned off because input buffer is becoming full. 

SI 8-level input 

so 8-level output 

XN Paper tape reader has been turned off and should be turned on again when there is room in the 
buffer. 

LI Input buffer full. "Don't listen for input bit." 

P Output routine is in the process of turning on the paper tape reader. 

AI Accept linked input bit. Currently not used. 

AM Accept linked output. Teletype is willing to be linked. 

ADDR Address of echo-table 

TC Terminal character for 8-level output 



NOTE: These tables are indexed by teletype channel number. 



Figure 12. Teletype Tables 
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LCW 



TTYASG 



TTYTIM 



WERIS 



NL 


UNSUC 


CP 





LTTY 



9 10 



NL Teletype not linked to another 



17 11 
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UNSUC Number of teletype making unsuccessful linking attempt. That is, teletype was already linked, 
or in the 8-level mode, or busy, etc, 

CP Count of the number of control Ps that have been sent to start the paper, tape reader. CP is not used 

in conjunction with linking. 

LTTY Number of the linking teletype 



PACPTR of fork to terminate on escape or when TTY not in use 



27 777 
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ES 



Value of clock when last action occurred on this TTY 



1 23 

ES Last action on this teletype was an escape. 



•1, 0, or User Number 



23 



NOTE: These tables are indexed by teletype channel number. 



Figure 12. Teletype Tables (cont. ) 



Is almost full. Suppose a program requires an entire line of 
text before It can do any processing. It could then define 
the control characters as break characters. Once the pro- 
gram has been dismissed. It will not be reactivated until 
the entire line Is available. 

There are four standard echo tables in the system, referred 
to by the numbers 0, 1, 2, and 3. Zero Is o table In which 
the echo for each character Is the character itself, and all 
characters are break characters. Table 1 has the same 
echoes, but all characters except letters, digits and space 
are break characters. Table 2 also has the same echoes, 
but the only break characters are control characters (includ- 
ing carriage return and line feed) and exclamation mark. 
Table 3 specifies no echo for any character, and all char- 
acters are break characters. This table is useful for a pro- 
gram that wishes to compute the echo Itself. 

Each echo table is 32 words (3 characters per word) In length. 
The 8-bit characters are stored In trimmed ASCII code. The 
total character set Includes 96 characters. The Input 
character is converted to trimmed ASCII code. Therefore. 



the table look-up is done with a character that has a value 
between and 137B. 



The format of the echo table is: 



B 


Char 


B 


Char B 


Char 



1 

where 



789 



151617 
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B is 1 If this Is a break character. 

Char Is character to be echoed In trimmed ASCII 

code. If the character Is not to be echoed, 
character Is set to 1 . 



The echoes for characters having a trimmed ASCII value of 
in word 1 ; etc. 
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Consider echo table which will echo everything and 
break on everything. The echo for a B, C, or D (ASCII 
102, 103, 104) will be in word ET(>f26B and have the value: 



6054170 4B = 



11000010 



1000011 11000100 



302B 



303B 



304B 



= 102B, 103B, 104B plus break char- 
acter bit set 

The echo table a fork wishes to use can be set by executing 
a BRS 12 which causes TTYTBL (indexed by the teletype 
number) to contain the address of the chosen echo table. 



940 BYTE ADDRESSING 

An echo table can be thought of as a table of 96 consecu- 
tive bytes. For echo table 0, the byte addresses of the 
entries in the table would have values between ETO and 
ET0+137B. 



ETO 

ETO+3 

ETO+6 

ET0+135B 





















1 \ 









Word 
1 
2 



37B 



Therefore, the echoes for B, C, and D are in word 26B of 
the echo table in positions 0, 1, and 2, respectively. 



8-LEVELMODE 

Special provision is made for reading 8-bit codes from the 
teletype without sensing escape or doing the conversion from 
ASCII to internal. To switch a teletype into this mode, 
execute: 

LDX teletype number 

LDA terminal character + 40000000B 

BRS 12 

This will cause each 8-bit character read from the teletype 
to be transmitted unchanged to the user's program. The 
teletype can be returned to normal operation by: 

1. reading the terminal character specified in A, 

2, setting the echo table with BRS 12 

No echoes are generated while the teletype is in 8-level 
mode. Teletype output is not affected. 

A parallel operation, BRS 85, is provided for 8-level output. 
BRS 86 returns matters to the normal state, as does any set- 
ting of the echo table. 



Suppose an ASCII character has been input and the trimmed 
7 bits have been stored in CHAR in bits 14-23, 

LDA CHAR 

MUL =12525253B Divide by three 

A byte address can be converted to a word address by divid- 
ing it by three. The remainder from the division represents 
the byte position that the character has in the word. The 
multiplication by 12525253B (this constant effects a divide 
by three) will leave the word address in A, and bits and 
1 of B will contain 00, 01, or 10. We then: 

ADD TTYTBL, 2 Get address of Echo Table 



Load X with echo word 

Get 5 bits of B 

Extract 00, lOB or 20B 

Echo word in B, Shift count in X 



The proper character will now be in the last 8 bits of the A 
register. For example, in trimmed ASCII: 



CAX 




LDX 


0,2 


LCY 


5 


ETR 


=30B 


COPY 


XB, AX 


LCY 


8,2 



B = 102B 
C = 103B 

D = 104B 



102B/3 
103B/3 

1 04B/3 



26B 
26B 
26B 



(Remainder = 0) 
(Remainder = 1) 

(Remainder ~ 2) 



INPUT PATH 

To input a character from the controlling teletype (the tele- 
type on which the user of the program is entered) into loca- 
tion M in memory, the SYSPOP 



TCI 



M (teletype character input) 



is used. This SYSPOP reads the character from the teletype 
input buffer and places it into the 8 rightmost bits of loca- 
tion M. The remainder of location M is cleared. The char- 
acter is also placed in the A register, which destroys the 
former contents. 

Two interrupts and an additional buffer are associated with 
the input path. When the input interrupt occurs, the word 
is "pinned" into a buffer called ATTBUF (which is 30 words 
long). The input interrupt then arms the 205 interrupt. The 
205 interrupt is always active and is the lowest priority 
interrupt in the system; therefore it will be triggered as 
soon as it is armed. 

The 205 interrupt routine takes a word from ATTBUF, gets 
the appropriate echo character, attempts to process the 
echo, puts the input character into TTYBUF, and decides 
if a break character has just been received. 
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ATTBUF (one per system) has the following format 
A ATTBUF 



Char 







TTY 



^ 7 8 9 



17 18-23 



ATTBUF+29 



ATTBUT+30 



S 



Char 



TTY 



-30 
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where 



Char is ASCII character, 

DO is Data Overrun, 

TTY is Teletype Number 

Suppose a fork executes a TCI, As long as TIS2 is greater 
than a character is extracted from TTYBUF using the 
TIS5 pointer. When the 205 routine places this character 
into TTYBUF, it sends the echo if one is required, and none 
of the following conditions prevail: (1) output active, I,e,, 
TOS2 is negative, (2) no previous echoes were deferred, 
(3) teletype is not linked. If these conditions ore absent, 
the echo is sent and bits 16 through 23 of the word pointed 
to by TIS5 are reset. The echo is sent by placing it into 
the output position of TTYBUF, 

If the echo is not sent immediately (205 routine), it will be 
sent later by the TCI routine. The echo transmission is 
accomplished by moving the echo character to the output 
position of the TTYBUF word pointed to by TOS5. If the 
teletypes are linked, the echo will be placed into the 
output buffer of the linked teletype as well. 

If TIS2 is zero, the input buffer is empty, and the fork is 
dismissed with an activation condition of 11 ^' TTYTBL. Bit 
1 of TTYTBL is set to indicate that the fork is waiting for a 
break character. 

The 205 routine resets bit 1 of TTYTBL when a break char- 
acter is detected and also increments ACTR so that the 
scheduler knows that a fork on CTI is ready. The routine 
will take the same action whether a break character has 
been detected or not, if the buffer is within 10 characters 
(TTYEEW) of becoming full. 

The buffer becoming full presents a problem when the input 
is from paper tape. If the buffer is within 6 characters of 
becoming full, bit 2 (XOFF) of TTYTBL is set and the dummy 
output interrupt is sent. When the output interrupt routine 
Is entered and XOFF Is set, the paper tape reader Is turned 
off. XOFF Is then reset and XON (Bit 5 of TTYTBL) Is set 
to indicate that the reader must be turned back on. When 



the input buffer becomes empty and XON is set, the dummy 
output interrupt is generated, XON is reset and bit 7 of 
TTYTBL is set to indicate that the output interrupt routine 
should send out two interrupts and the XON ASCII char- 
acter to reactivate the paper tape reader. Bits 8 and 9 of 
LCW are set to keep track of the number of interrupts that 
hove been sent. The two interrupts are sent for timing 
purposes. This guarantees that the teletype has finished 
processing the XOFF request before turning it back on. 



MISCELLANEOUS TABLES 

Any time an action occurs at a teletype (either input or out- 
put) the value of REAL is stored into TTYTIM, If a user hits 
two high-speed escapes, this indicates he wishes to return 
to the Executive fork. When a rub-out is processed, the 
value in TTYTIM is compared with REAL to determine if this 
was a high-speed escape, TTYTIM is set to -1 If high-speed 
rubout was received, TTYTIM is also set to -1 in TSOFF 
when an off interrupt has been received, 

TTYASG Is initialized to 37777B when the teletype becomes 
inactive. While the teletype Is active TTYASG contains 
the negative pointer to the PAC table of the fork to be ter- 
minated when any panic occurs, 

WERIS = -1 when teletype Is inactive, when the user Is in 
the process of logging on, and user number after the user has 
logged on. 



LINKING OF TELETYPE 

It Is possible for one teletype to accept linkage to another, 
break the linkage, or refuse to be linked. When the user 
logs on the system, bit 9 of TTYTBL, the accept message 
bit. Is set, 

LCW is initialized to 40000040B, Bit indicates that 
the teletype is not linked and 40B Is a fictitious teletype 
number since the legitimate numbers are through 37B 

Once a teletype is linked, the associated teletype numbers 
are inserted Into bits 18 through 23 of the LCW word of both 
teletypes. The teletype output routine checks bit to see 
if NL Is reset. If it Is, the output character Is placed Into 
the TTYBUF for both teletypes. 

In order for one teletype to link to another, bit 9 of TTYTBL 
(the accept message bit) must be set. Also, the teletype 
must not be in the 8-level mode, be already linked, or 
have just turned off the paper tope reader or be In the proc- 
ess of turning It back on. All these conditions will cause 
the link to be unsuccessful and the number of the teletype 
that attempted to link will be placed In bits 1 through 7 of 
LCW. 
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9. DEVICES AND TS PAGE BUFFERS 



FILE STORAGE ON DISC 

The physical records for fhe storage of files are divided into 
blocks of 256 words. The files use the disc in groups of 4 
sectors of 64 words each. 

The disc files used by this system consist of 8 to 32 physical 
discs, with each disc having a movable arm. The arms have 
64 positions numbered to 63 and each arm position on a 
disc can access 8, 192 words. Each arm position contains 
four pages (a page is 1/4 of an arm position) and one page 
contains 2, 048 words. It is possible to access four pages 
without moving an arm position (see Figure 13). 

For example, if the total number of arm positions is multi- 
plied by the number of words per arm position, the total 
number of words per disc can be calculated (i.e., 8, 192 
words X 64 arm positions equals 524, 288 words per disc). 

The disc is divided into two major sections: system data 
and file storage. The disc map in Figure 13 illustrates the 
disc sections. Octal addresses 0, 40, 100, 140 are the 
beginning addresses for the four pages in a specified arm 
position. In this addressing scheme, each increment of one 
represents a sector of 64 words. Therefore, four addresses 
such as 0, 1, 2, and 3 would represent a physical record 
containing 256 words. 

"User 400 FD" in arm position at disc represents the file 
directory of the individual's user number, "Acct "- 1 UAD" 
(arm position 1 at disc 4) is the user's account directory for 
for account fi 1 . 

The format for the disc address word Is shown in Figure 14, 

Figure 15 shows the flow necessary to retrieve a disc file. 
When a user logs on the system, the account number is used 
to calculate the disc address of the User Account Directory 
(UAD). The UAD contains a list of the user names associated 
with this account. Associated with each user name is the 
status of the user and his user number. The user number is 
assigned to a user by the operator. It can be used to calcu- 
late the disc address of the file directory associated with 
this user name. 

A file directory (FD) is 128 words long and contains the 
ASCII name of a file and four control words that specify 
parameters peculiar to the file for all the files that pertain 
to this user. The number of files that can be represented in 
the file directory is a function of the length of the file 
names. If a user gives all of his files 3 character names, 
there would be room for about 24 files. One of the param- 
eters that is associated with each file is the disc address of 
the index block. 

Every file is written on the disc in data blocks of 255 words. 
The index block contains the disc address of the data blocks 
for the file. Currently the index block contains pointers 



(disc addresses mod 4) for 76 data blocks. Therefore, a file 
may be 255 x 76 or 19, 380 words in length. 

When a file is written, the system collects 255 words in a 
buffer, searches a disc bit map for an available area, and 
writes the contents of the buffer on the disc. The disc 
address is stored into the index block. When the file has 
been completely written, the index block will then be 
written on the disc. 

The formats for the UAD and the FD are shown in /Appendix 
C. The layouts of the file buffer and of the index block 
buffer are shown in Figure 16. 

Available storage in the file area of the disc is recorded in 
a bit table, A bit indicates that the corresponding block 
on the disc is free. The bit map is set every time the sys- 
tem is updated to agree with the files in the file directories. 
To set the bit map, BRS BE+5 is used, requiring index block 
pointer (mod 4) in A, When all files have been checked, 
the BRS is called with A set to -1, the new overflow pointer 
in B, and the accounting area address in X. 

FILE BUFFERS 

Every open file in the system with the exception of purely 
character-oriented files, such as the teletype, has a file 
buffer associated with it. The form of this buffer is shown 
in Figure 16. The index block is used only by disc files 
but is present in all cases. Each user has three buffers in 
his TS page. Therefore, any user can have a maximum of 
three files open. The Monitor always relabels the TS page 
into logical page 7, 

Note that the amount of buffer space actually used is a 
function of the device attached to the file. In all cases, 
the two pointer words at the head of the buffer indicate the 
location of the data. The first word points to the beginning 
of the relevant data and is incremented as data isread from 
or inserted into the buffer. The second word points to the 
end of the data. On the output path, the second pointer is 
set to the physical record size that pertains to the device. 

On the input path, this pointer is set by the routine that 
drives the device once It determines the number of words 
read. When the buffer pointers are equal, the buffer is 
either empty (input) or full (output). 

The size of a TS page buffer Is: 

255 Data Words 

2 Buffer pointers 

6 Index Block parameters 

128 Size of Index Block (only 76 words ore used) 

391 Words per buffer 

Although only the disc files require on index block, every 
device that requires a TS page buffer is assigned a 391 
word buffer. 
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Physical disc Bits 6-10 specify one of the 32 possible discs in the file unit. 

Logical track pair Bits 1 1-18 specify one of the 256 track pairs on the disc. A track pair consists of one outer and 

one inner track. 

Bits 1 1-16 specify one of the 64 positions of the access arm. 

Bits 17-18 specify one of four logical pairs that can be accessed without moving the arm. 

Sector Bits 19-23 specify one of the 32 sectors in each logical track pair. Two disc revolutions are required to 

access the 32 sectors on one logical track pair. 

Bits 17-23 specify the 128 sectors that can be accessed without moving the arm. Eight disc revolutions are required 
to access the entire sector string from one arm position. 



Figure 14. Disc Address Word 
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Figure 15. Flow Required to Access a Disc File 
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File Buffers 



BUFF 



BUFF + 256 

BUFF + 257 = BIN 
BIC 
BDN 
BDC 
BIP 
BIA 
BXO 



Layout of Data Block and Pointers 



Pointer to first relevant data word of buffer 



Pointer to last relevant data word of buffer 



First data word 



255th data word 
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Layout of Index Block Buffer and Associated Pointers for a Disc File 
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BIN When a disc data block is written, 256 words ore output. The 256th word (contents of BIN) specify the 

number of words in the record. 

BIC Initialized to -1. Incremented by an output operation to indicate that the Index block must be output 

when the file Is closed. 

BDN Initialized to -1. Currently not used. 

BDC Initialized to -1. Incremented by an output operation to Indicate that the data block must be output to 

the disc. 

BIP Contains BUFF + N where BUFF is the TS buffer address and N points to the entry In the index block that 

is being used. 

BIA Storage for the disc address of the Index block that Is currently being used. 

ERR, EOF, EOR Flags that are set by the device drivers, Indicating error, end-of-flle, and end-of-record, 

respectively. These flogs are checked by the GPW (Get/Put Word) routine. 

BXO Beginning of Index Block. Al I disc addresses are Mod 4. 



t-igure 16. File Buffer 
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DEVICES 

Every input/output device attached to the system has a 
device number. The numbers assigned to specific devices 
are given in Table 3. The various tables indexed by device 
number are described in this section. See Figure 17. The 
entries in these tables are specified by assembly parameters. 

The ma;or parameters of a device are: 

1. the opening routine, which is responsible for the opera- 
tion needed to attach it to a file. 

2. the GPW routine, which performs character and word 
I/O. 

3. the BIO routine, which performs block I/O. 

4. the SEL routines, which perform the physical device 
I/O. 

The minor parameters are: 

1. maximum legal unit number. 

2. physical record size (determining the proper setting of 
buffer pointers and interface control words for the 
channel), and the expected time for an operation. 

Table 3. Device Numbers 



Device 


Number 


Paper Tape Input 


1 


Roper Tape Output 


2 


BCD Tape Input 


3 


Magnetic Tape Input 


4 


Magnetic Tape Output 


5 


Hollerith Card Output 


6 


Binary Cord Output 


7 


BCD Tope Output 


10 


High Speed Printer Output 


11 


Hollerith Card Input 


12 


Binary Card Input 


13 



When a file is opened, the device number is specified. The 
device number is used to index into the device tables. The 
device-dependent parameters are abstracted from the device 



tables and stored in the file control block (see Figure 18). 
Every open file in the system has a file control block asso- 
ciated with it. 

Figure 17 shows tables indexed by device number. The DEV 
table specifies various characteristics of the device and the 
address of the entry point into the GPW (Get/Put Word) 
routine. This routine is used by the CIO, WIO, and BIO 
SYSPOPs. On the input path the GPW routine will take a 
word from the buffer in the TS page and place it in the A 
register. When the buffer becomes empty it will call the 
device driver (whose address is specified in SEL) and read 
the record size (specified in BUFS) into the TS page buffer. 
The opposite flow is taken for the output path. Word of 
the DEV table contains the FD word (see Figure 18) of the 
currently active file. 

The DID table will contain an entry of -1 if the device is 
not in use. If the device is in use it will contain the file 
number of the file using the device. The disc will never 
have a meaningful entry in this table since it can be accessed 
by more than one user at one time. For magnetic tape it is 
not sufficient to indicate whether the "device" is busy since 
there may be several magnetic tape units. Therefore, the 
DIU entry for magnetic tape points to another array named 
ADIU. ADIU is indexed by tape unit number and contains 
the same information (-1 or file number) for each tape unit. 

The address portion of the OPNDEV table contains the 
addresses of the routines that are called by BRS 1 to open a 
particular device. Bits 3-8 of this table contain the maxi- 
mum amount of time (in 60 HZ clock ticks) that should occur 
once this device has started. Any routine that initiates 
action at a device will extract these bits and store them 
right justified into FTIME. The clock interrupt will decre- 
ment FTIME; if it becomes negative, action is taken to try 
to correct the fault. Once an interrupt from an I/O device 
is received, FTIME Is set positive (37777777^). 

SYSTEM DATA ON OUTER ARM POSITION OF DISC 

Arm positions 62 and 63 contain systems which are loaded 
by a utility routine named DSWAP. This routine dumps the 
first 32K of core on discs and 1, then reads a nev/ system 
into the first 16K of core. The disc from v/hlch the nev/ 
system is read is determined by console switch settings. 

Arm positions and 1 contain the file directories, account- 
ing information and data. 

BRS'S FOR DIRECT DISC ACCESS 

There are four BRSs available to system level forks to read 
and write the system data on the disc. These are: BRS BE-1, 
BRS BE+2, BRS BE-^9, and BRS BE^IO. They require the core 
address in A and the disc address in B. In addition, BRS 
BE + 1 and BRS BE+2 require the word count in X. BRS BE-9 
and BRS BE + 1 always read or write a page (2K) from or to 
the disc. 
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DEV word 



BUFS 
Buffer size 



BDEV 
Block I/O 

Routine 



DIU 

device in 
use 



OPNDEV 

Opening 

Routine 



SEL 









D 










O 












c 


S 


R 





B 


W 


U 





GPW routine 






H 


C 


X 




F 


B 


T 







0123456789 10 



23 



CH a character oriented device. The WIO and BIO POPs cannot be used to 

access this device, 

DSC indicates the device is the disc. This bit determines whether to relabel 

in the WPAGE or DISC files into page 6 of the Monitor's relabeling, 

BF device uses one of the buffers in the TS page. Presently all devices have 

this bit set, 

WD W buffer device. Presently this bit is not used, 

OUT Output device. 









N 

c 


Max unit 
number 


U 


Physical record size 



12 3 



8 9 10 
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NC not common. Most devices can be accessed by only one file at a time. 

This is not true of the disc. This bit is set for the disc. 

Unit the maximum unit number. Applies to multi-unit devices (such as mag- 

netic tape). Presently magnetic tape units and 1 are used. 

U indicates this is a multi-unit device such as magnetic tape. 









Entry into BIO routine 



9 10 



23 



File number using this device or -1 



Point to ADIU (has unit number added) if multi-unit device U - 1 



U = 



23 









Expected 












E 
O 


wait time 
in cycles 





Opening subroutine 



12 3 



8 9 10 
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EO Executive only allowed to open 






n 




C 

s 


P. U. Test 





Device driver address 



12 3 



8 9 10 
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CS check user's status 



Fiaure 17. Tables Indexed by Device Number 
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10. SEQUENTIAL FILES 



FILE NUMBERS 

The term "file" refers to: 

1, A disc file (i. e. , a collection of data that has been 
named and output to the disc in blocks of 255 words). 

2, A magnetic tape file (i.e., a collection of sequential 
blocked records that have been output to magnetic 
tape), 

3, A physical device. 

When a file is opened, the system will return a file number. 
The system may have up to 40 files opened. The user may 
have a maximum of 3 files that require a buffer open, as he 
is restricted by the number of available TS page buffers. 



The file numbers range between and 39 and are assigned 
in a somewhat random manner. As a user opens a file, he 
is assigned a free file number. When the file is closed, the 
number is returned to the free file number list which is kept 
in the FA table (see file control block). 

Once the file number has been assigned, the user references 
the file by that number. Note that the I/O SYSPOPS (CIO, 
BIO, WIO) require the file number as an argument. 

FILE CONTROL BLOCKS 

Every open file in the system has a file control block asso- 
ciated with it. This block consists of four words shown in 
Figure 18. 



FA 



First index block address or or subroutine 
address or unit number 
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FC 



Char, 
count 


Job no. 





Disc buffer address or 


2 3 


8 9 10 






23 


S 


s 


S 



FW 



U FA contains o free file number. 

ERR Error occurred at the device. 



BB When action at the device is initiated this 

bit is set. When the interrupt occurs this 
bit is reset. If a fork is dismissed for I/O, 
the PTEST word points to FD, This bit is 
examined to determine when to reactivate 
this fork. 

CH Character oriented. See CH in DEV table. 



15 16 
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DF Disc file. See DSC in DEV table. 

RD Read only. 

BP The file is using one of the buffers in the 
TS page. 

OUT Output file. 

Char, count -1 to 2. 

Cn Word being packed or unpacked. 



Figure 18, File Control Block 
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This block is initialized when the file is opened. The file 
control block tables are indexed by file number. Note that 
the FD entry contains the device nurrfcer of the physical 
device that is attached to the file. The system can use this 
number to reference the physical device tables. The entries 
in these tables provide the information that is necessary to 
completely define the file. 

The FA array contains free file numbers. The word FFLST 
contains the next free file number. The corresponding entry 
in FA will contain the next available file number or if 
there are no free files. The free file list is initialized in 
TTYSET, When a file is in use, FA will contain the disc 
address of the index block for a disc file or the magnetic 
tape logical unit number for a magnetic tape file. FA is 
not used for any other device. 

The FC array contains the address of the TS page buffer 
that is being used by this file and the job number of the 
user. The job number is set to 77B for a permanently opened 
file. The character count has significance if the CIO Is 
being used to access a word-oriented device. On the input 
path, CIO will fetch a word from the buffer, store it into 
the FW array, and return a character to the calling program. 
Subsequent CIO calls will retrieve a character from FW. 
When all of the characters in FW have been sent, the next 
CIO call will again fetch a word from the buffer. The 
opposite flow occurs on the output path. The character 
count in the FC word has the following significance: 



Configuration Input 

1 1 ] There are no characters In FW. 

Call GPW to get a word. 

001 There are 2 characters in FW. 

000 There Is 1 character in FW. 



3, The buffer pointers are initialized. 

4, Where applicable, a check is made to determine if the 
device is already in use, 

5, A call is made to the opening routine that is associated 
with this device. See OPNDEV table, 

6, The file control block is initialized. 

The operations performed by the device opening routines 
depend on the complexity of the device. For many devices, 
the routine simply issues a device ready test. The disc open- 
ing routine must obtain and initialize the index block for 
the file. 

A file must be closed when Its processing has been com- 
pleted. This is accomplished by executing a BRS 2 with the 
file number In the A register. BRS 2 is available to both 
user and Executive programs. To close all his open files, 
the user may execute a BRS 17. Closing the file releases 
it for other uses. The file number and the buffer are also 
released. 



ACCESSING THE TELETYPE AS A FILE 

The teletype can be a accessed by using the CIO SYSPOP. 
However, the teletypes do not require a TS page buffer. 
Each teletype on the system has a dedicated buffer which 
Is core resident. Chapter 8 describes the teletype buffers. 
When the teletype Is accessed as a file. It does not have 
to be opened since the teletype Is a permanently opened 
file. 



PERMANENTLY OPEN FILES 



010 
001 
000 

in 



Output 

There are no characters In FW. 

There Is 1 character In FW. 

There are 2 characters In FW. 

There are 3 characters in FW. 

Call GPW and place the FW word Into the 

buffer and place this character Into FW. 



OPENING AND CLOSING FILES 

In order to manipulate a file. It must first be opened. The 
BRS 1 Is used to open files. If the file is opened successfully, 
the BRS skips. Use of this BRS Is restricted to users with 
system status. User programs may access files only through 
the Executive. 

Opening a file accomplishes the following: 

1. A file number is assigned. 

2. An available TS page buffer Is dedicated to this file. 



The system has the following built-in sequential files with 
fixed file numbers: 

controlling teletype input 

1 controlling teletype output 

2 nothing (discard all output) 
1000+ n Input from teletype n 
2000 + n output to teletype n 

SEQUENTIAL DISC FILES 

A sequential file has o structure very similar to that of an 
ordinary magnetic-tape file. It consists of a sequence of 
logical records of arbitrary length and number. Disc sequen- 
tial files, ore however, considerably more flexible than cor- 
responding files on tape, because logical records may be 
inserted and deleted in arbitrary positions and increased or 
decreased in lenath. 
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A sequential disc file may be opened by the following 
sequence of instructions: 

LDX device number, 8 (input) or 9 (output) 

LDA Address of the index block (mod 4) 

BRS 1 

If a new output file is being opened, the A register should 
be since an index block does not exist. 

If BRS fails to skip, it returns in A the following: 

-1 Device already in use. For the disc, produced by 
an ottempt to open o file for output twice. 

-2 too many files open — no file control blocks or 
no buffers available. 

-3 no disc space left. This inhibits opening of output 
files only. 

BRS 1 returns the file number in the A register and the disc 
accress (mod 4) of the index block in the X register. 

A file that is open for output cannot be opened again for 
either input or output and a file that is open for input can- 
not be opened for output. However, a file may be opened 
for input any number of times. 

The disc opening routine will read the index block into the 
buffer and initialize the index block pointers. If this is a 
new file, the disc bit map will be checked and an available 
space for the index block is obtained and the index block 
area (BXO and following) in the buffer will be reset to 0. 

When the first I/O SYSPOP is encountered on the input 
path, the index block will be referenced and the data 
block read. The 256th word read will cause the next data 
block to be read. This process is continued until an index 
block entry of is obtained (i.e., all of the data blocks 
have been read). The EOF or EOR flags will be set in the 
second word of the buffer. 

When a file that already exists is used for output, the first 
attempt to write the data block will cause all of the old 
data blocks, as specified in the index block, to be released 
to the bit map. An available disc block will be obtained, 
the data block written, and the address of the data block 
will be stored into the first index block entry. Another 
disc block is also obtained in preparation for the next data 
block write. This disc address is stored into the next posi- 
tion (obtained by incrementing BIP) of the index block. 

Subsequent requests to write the data block will use the 
disc address that is pointed to by BIP, increment BIP, and 
obtain another available disc block. This process will con- 
tinue until the index block is full or the file is closed. 



If a new output file is being written the path is similar to 
the one described above except that there is no need to 
release the old data blocks. 

When an output file is closed, the remaining words in the 
buffer are written on the disc. The EOF flag is set in the 
index block entry that points to the last data block. The 
index block is then sent to the disc. The disc address of the 
index block was stored in BIA when the file was opened. 



I/O SYSPOPS 

Three kinds of input/output may be done with sequential 
files. They are: character input/output (CIO), word input/ 
output (WIO) and block input/output (BIO). Each of these 
SYSPOPS can perform input or output since the file must be 
specified as an input or an output file when it is opened. 

To input a single character to the A register or output it 
from the A register, the instruction 



CIO 



fil 



e number 



is executed. During input, an end of record will set bits 
and 8; an end of file condition will set bits and 7 in the 
file number. These are called flag bits. An end of record 
will return a I34B character; an end of file, a 137B char- 
acter. If interrupt 4 is armed, it will occur. The end of 
record condition occurs on the next input operation after 
the last character has been input. The end of file condition 
occurs on the next operation after the end of file, which 
signals the last record of the file. The user may generate 
an end of record while writing a file using the control oper- 
ation to be described. An error condition sets bits and 6 
in the file number. 

To Input a word to the A register or output It from the A 
register. 



WIO 



file number 



mod 4 means the lowest 4 bits are truncated, mod 5, the 
lowest 5 bits, etc. 



Is executed. An end of file condition returns a word of three 
137 characters. A/'Ixing word and character operations Is not 
recommended. 

To Input a block of words to memory or output them from 
memory, the instructions 

LDX first word address 

LDA number of words 

BIO file number 

should be executed. The contents of A, B and X will be 
destroyed. The A register at the end of the operation con- 
tains the first memory location not read into or out of. 

If the operation causes any of the flag bits to be set. It Is 
terminated at that point and the Instruction falls to skip. If 
the operation is completed successfully it skips. Note that 
a BIO cannot set both the EOR and the EOF bits. 
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The flag bits of the file number are set by the system 
whenever end-of-record (0 and 8) or end-of-file (0 and 7) 
is encountered and cleared on any input/output operation 
in which neither of these conditions occurs. Bit is set on 
any unusual condition. In the case of a BIO the A register 
at the end of the operation indicates the first memory loca- 
tion not read into or out of. For any input operation, the 
end of record bit (bit 8) of the file number may be set. An 
output operation never sets either of these bits. Bits and 
6 of the file number may be set on an error condition. 
Whenever any flag bit is set as a result of an input/output 
operation in a fork, interrupt 4 will occur if armed. 

A program may delete all the information in a disc file by 
executing the instructions: 



LDA 



BRS 



fil( 



66 



iber 



Putting the file number of a sequential file in A and exe- 
cuting BRS 113 will cause the file to be scanned to find the 
total number of data words. The number of data words is 
added to X, 

A new disc file with a new index block can be created by 
BRS 1 with an index block number of in A. The file num- 
ber is returned in A and the index block number in X. The 
read-only bit may be set (bit of A) and 

BRS 67 

returns the index block with address to available storage in 
A. An executive fork may read an index block into core 
with 

BRS 87 

which obtains the address of the block from A, and X will 
contain the address of the first word in core into which the 
block is to be read. 



OTHER SEQUENTIAL FILES 

In addition to disc sequential files, the user has other kinds 
of sequential files available to him. These are all opened 
with BRS 1: 

LDX device number 

LDB RECL (BCD tape output only) 

LDA unit number 

BRS 1 

RECL is positive for 80 characters and negative for 132 
characters. 

The device number is put into X. The unit number, if any, 
is put into A. The file number for the resulting open 
file is returned in A, If BRS 1 fails, it returns an error 



condition in A, Three error conditions apply to magnetic 
tape only: 

Tape not ready 

1 Tape file protected (output only) 

2 Tape reserved 

BRS 1 is inverted by BRS IIQ, which takes a file number in 
A and returns the corresponding device number in X and 
unit number in A. 

These files may also be closed and read or written in the 
same manner as sequential disc files. The magnetic tape 
is not available to the user as a physical device. 

CTRL ~ 1 (end of record) 

Is available for physical sequential files 2, 5 and 10 (paper 
tape and magnetic tape output). Other controls available 
for magnetic tape files only are listed in Table 4, 

Table 4. File Control for Magnetic Tape 



Operational 




Control 


Magnetic Tape File Control 


No. 




2 


Backspace block 


3 


Forward space file 


4 


Backspace file 


5 


Write three inches blank tape 


6 


Rewind 


7 


Write end of file 


8 


Erase long gap 



These controls may be executed only by Executive tape 
programs. 

An Executive program may allocate a tape unit to itself by 
putting the unit number In A and executing BRS 118, which 
skips If the tape is not attached to some other job. BRS 1 19 
releases such a tape. 

The format for magnetic tape (devices 4 and 5) is shown in 
Figure 19. Note that the records ore 200 words in length. 
For compatabi llty with earlier versions of the system, mag- 
netic tapes (devices 4, 5) have three dummy records after 
the load point. The records are placed on the tape by the 
operator's NEWTAPE program. 

The format for BCDTAPES (devices 3 and 10) is shown in 
Figure 20. 
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200 words 



199 word dummy 
date block 



■200 words 



End of Tope 



199 word data 
block 



p(e 


X word 


1 


1 


P 


E N 


data 


3 . . 


. 3 


E 


R W 


block 


7 


7 


R 



Filler 



3 feet 
of gap 



P 
E 
O 
F 



1-1 



199 word dummy 
data word block 



FTPN Tope file position number (e.g., the fifth physical file on the tape will have FTPN=5). Note that the first 

record of every file contains FTPN as the first word and 199 dummy words, 

PER Physical end of record. 

NW First word of a record contains the number of words in the record. 

ENW Same format as NW only bit is set to indicate this is the last record of the file. The last record contains 

X words of data. The remainder of the record is padded with 137B characters. 

PEOF Physical end of file. 

Filler A record (0.5% of the original file length) of 137B characters. 

3 Feet Gap Allowance for expansion of the file. 

End of Tape The last file on the tape is followed by a dummy record with NW = -1. 



Figure 19. Format for Magnetic Tape Files 
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PER Physical end of record. 




PEOF Physical end of file. The last file on the tape is followed by two PEOFs. 




Record Length 3 to 132 characters for input and 80 or 132 characters for output. 




NOTE: 79, 80, or 81 character lengths will be assumed to be 80 character transformations (card images). 



Figure 20. Format of BCD Magnetic Tape 



It is possible for magnetic tope and cord reader files to set 
the error bit in the file number. The first I/O Instruction 
after an error condition will read the first word of the next 
record; the remainder of the record causing the error is 
ignored. The magnetic tape routines take the usual cor- 
rective procedures (i.e., reread or rewrite) when they see 
hardware error flags, and the routines signal errors to the 
program only as a last resort. 

In order to make the card reader and BCDTAPE look more 
like other files in the system, the following transformations 
are mode by the system on card input: 

1. AvAore than fwo blanks are converted to a 135 character 
followed by a character giving the number of blanks. 
The teletype output routines will decode this sequence 
correctly. 

2. Trailing blanks are not transmitted to the program. 



3. The character 155 (carriage return) Is added to the end 
of each transformation. 

The result of this configuration Is that the string of charac- 
ters obtained by reading in a card deck or a BCDTAPE file 
may be output without change to a teletype and will result 
in a correct listing of the deck. 

Whenever a card reader error (feed check or validity check) 
occurs, the program is dismissed until the reader Is ready. 

The EOF light is sensed as an end of file at all times. 

Because of critical timing requirements, the card punch 
should be operated when there is but one user In the system, 
i.e., the operator. 

Because of the interactive nature of the system peripherals, 
device speeds will decrease as the number of users in the 
system increases. 
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11. SUBROUTINE FILES 



In addiHon to the previously mentioned operations for 
performing input-output through physical files, a facility is 
provided within the system for making a subroutine call 
appear to be an input-output request. This facility makes 
it possible to write a program which does input-output from 
a file which causes further processing to be performed before 
the actual input-output is done. This is accomplished by 
simply changing the file from a physical to a subroutine 
file, A subroutine file Is opened by executing the 
instructions: 



LDX 
BRS 



parameter word 



1 



The instruction never skips. The operation code field of the 
parameter word indicates the characteristics of the file. It 
may be one of the following: 



110 00000 (octal) 

111 00000 (octal) 
010 00000 (octal) 
Oil 00000 (octal) 



Character input subroutine 
Character output subroutine 
Word input subroutine 
Word output subroutine 



I/O to the file may be done with CIO or WIO, regardless 
of whether it is a word-oriented or a character-oriented 
subroutine. The system will take care of necessary pack- 
ing and unpacking of characters. BIO is also acceptable. 



The opening of a subroutine file simply creates a file 
control block and returns a file number in the A register. 
When an I/O operation on the file Is performed, the sub- 
routine is called. This is done by simulating an S B RM to 
the location given in the word following the BRS 1 which 
opened the file. The contents of the B and X registers 
are transmitted from the I/O SYS POP to the subroutine 
unchanged. The contents of the A register may be changed 
by the packing and unpacking operations necessary to 
convert from character-oriented to word - oriented opera- 
tions or vice versa. The I/O subroutine may do an arbi- 
trary amount of computation and may call on any number 
of other I/O devices or other I/O subroutines. A sub- 
routine file should not call itself recursively. 



When the subroutine Is ready to return, it executes BRS 41. 
This operation replaces the SBRR which would normally be 
used to return from a subroutine call. The contents of B 
and X when the BRS 41 Is executed are transmitted unchanged 
back to the calling program. The contents of A may be 
altered by packing and unpacking operations. A subroutine 
file is closed with a BRS 2. 



In order to Implement BRS 41, It is necessary to know which 
I/O subroutine is open. This information is kept In 6 bits 
of the PAC table. These 6 bits are transferred Into the 
operation code field of the return address when an I/O 
subroutine Is called, and are retrieved when the BRS 41 is 
executed. 
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GENERAL DESCRIPTION 

The user's sole access to files is through the Executive. The 
Executive provides a connection between a symbolic name 
for a file created by the user, and the file numbers the user 
must have to execute Input/output operations. This con- 
nection is established through the file directory. Supple- 
mentary to this function is the need to prevent the user from 
damaging or destroying other users' files. 

The first part of this section describes the file naming sys- 
tem as it appears to the user, the second part describes the 
Executive tables that Implement various features. 

A user may give his files arbitrary names containing any 
characters other than ' or/, because the names of disc files 
must be surrounded by/, and the names of tape files by '. 



When a user types a file name not enclosed within slashes or 
quotes, he need only type enough characters of the name to 
uniquely define It. If the user starts an output file name with 
o quote or slash, he must type the entire name. If it is an 
output file name and not already in his file directory, a new 
file will be created. In any other context, a name not in 
the file directory is in error. 

When an output file name is being typed, the system, after 
determining the name, will type out either OLD FILE or 
NEW FILE and await a confirmation that the name has been 
given correctly. If the user types either a line feed or a 
carriage return, the name will be regarded as correct. Any 
other character will be regarded as an indication that the 
name was incorrect. This procedure is designed to make it 
more difficult for the user to destroy old files or create new 
ones inadvertently. 
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when a user gives a new (slashed) output file name to the 
system, this creates a new entry in the file directory and a 
new index block on the disc. 



The user is allowed to reference files belonging to other 
users if the file name to be referenced contains at least one 
control character or an CcO. He does this by typing that user's 
account number and name, enclosed in parentheses, before 
the file name. Thus, to get at file/'a) PROGRAM/iaelong- 
ing to user JONES, he types 

(AIJONES)/" PROGRAM/ 

In this way Jones can control the extent to which other 
users access his files. 

Files in a public file directory may be accessed by typing the 
file name in quotes 

"PROGRAM". 

It is possible for o user to rename his files by typing for 
example 

RENAME /PROGRAM/ AS /ROUTINE/ 

The rename logic protects the user against creating file names 
that conflict with existing file names or with the file type. 



PHYSICAL DEVICES 

Some of the physical devices con be accessed as files. There 
are six file names built into the system: 



BDCTAPE 

CARDS 

PAPER TAPE 

PRINTER 

TELETYPE 

NOTHING 



the user must have peripheral 
status to use these files 



Available to ail users 



These names may be used at any time. If the device 
referred to is not available because it is attached to some 
other user, a suitable error message will be generated. 
Paper tape output files opened by giving this name to the 
Executive will have the type of the file punched as the first 
word. Similarly, paper tape input files opened by giving 
this name to the Executive will read the first word as the 
file type. 

There are four standard file types: 

1. File written by Executive save command (sequential) 

2. Uenerai binary file (sequential) 

3. Symbolic file (sequential) 

4. Dump file (sequential) 



STRING POINTERS 

Many of the BRSs that deal with file manipulation require 
string pointers as arguments, A string pointer is a character 
address found by multiplying the word address by three and 
adding 0, 1, or 2, The string pointer PI points to the char- 
acter before the beginning of the file name. The pointer 
P2 points to the last character of the name. 

TAP assembles string pointers as follows for string pointers 
PI and P2: 



PI 



DATA (R) Z-1 



P2 DATA (R) Z+2 

Z ASC 7T/' 

Suppose that Z was at location 1000B. Then PI would have 
the value 2777B and P2 would equal 3002B. See "Special 
Relocation" section of TAP reference manual for discussion 
of (R) in the DATA operators above. 

THEORY OF HASHING 

"Hashing" is a technique of having the system assigna "num- 
ber" to a character string to avoid the need for a character- 
by-character search through an entire list of character strings. 
This number is calculated by adding the number of characters 
in the string and the ASCII code for the first and last three 
characters, and dividing the sum by a constant. This algor- 
ithm associates a number with a character string, and the 
information associated with the string can now be filed in 
a table indexed by the "hash number". 

The number will not be unique. There are three words of 
data associated with each hash table entry. After a user's 
file directory has been read from the disc, the pertinent 
information can be abstracted from the file directory and 
stored into the hash table. If two strings produce the same 
hash number (HN), the second entry is placed in the first 
available space preceding the calculated hash number (lower 
numbered core location). All unused hash table locations 
contain 0. 

Assume the following hash numbers for a user's files: 

File Name Hash Number 



SMITHJ 
SMITHM 
FILANAM 
FILBNAM 



M 
N 
P 
P 



If FILANAM is inserted before FILBNAM, the hash table will 
have the format shown in Figure 21. 

The first two of the three data words contain string pointers 
to where the character strinq for the file name is stored. 
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TABLE 
TABLE +N 




• Unused 
- 
► SMITHM 







K 






Unused 


TABLE + P 


\l 


► FILBNAM 
• FILANAM 














K 




N 


Unused 


TABLE + M 


"^ 


> SMITH 
Unused 








K 




\| 





Figure 21. Hash Table 



The third is the "hash value word" which is a data word 
pertaining to the particular entry. When the system wishes 
to retrieve file information, it must be able to verify that it 
has found the correct file. 

The system can retrieve information about a specific file by: 

1. calculating the hash number; 

2. verifying that the string names match, or if not, search- 
ing the table backward and cycling around until all the 
entries have been searched; and 

3. returning, if successful, the word address of TABLE+HN 
in the B register. 



If the search is successful, the following coding will retrieve 
the three data words associated with the file: 



CBX 



LDA 0,2 First Data Word 

LDA 1,2 Second Data Word 

LDA 2, 2 Third Data Word 
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wi - 

W2 - 



c c c 
1 2 c 



"j "k^l 



— First 3 characters of the string 

— Last 3 characters of the string 



N 
L 
[] 



Number of characters in the string 
Length (number of words) in the hash table 
Integer divide (ignore remainder) 
X = 8*N + Wl 



0- 



Wl + W2 + W2 

12-23 0-11 11-23 



Y = ~ = Quotient + R (remainder) 



HN = |- * 3 

R is some value between and L-1. HN is an even multiple 
of 3 since the hash table is grouped by three. 

If the character string contains 3 characters or less, the 
algorithm is slightly different. The missing characters in Wl 
and W2 are effectively reset to 0. 

THE HASHING TABLE 

There are three hashing tables used by the 940 software: the 
file directory, the commands, and the subsystem-names hash 
tables. 

A hashing table consists of four distinct parts (see Figure 22, 
hashing tables for the file directory): 

1. Control table —contains pointers into the other parts of 
the table. 

2. Hash table — contains string pointer into the string stor- 
age area and other information pertinent to the entry. 

3. Corresponding table — indexed parallel to the hash table. 
It contains three words of additional information per- 
taining to the entry. The commands hashing does not 
require a corresponding table. 

4. String storage — stores the character string for each 
entry. The hash table entry conrains pointers into 
this area. 
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The four parts of the table need not occupy contiguous core 
locations. 









Control 
Table 


FDCTL 

FDCTLl 
FDCTL2 
FDCTLC 

FDCTLE 


Word Addr-Begin Hash 
Table 


Word Addr-End Hash Table 


Working Cell 


Char. Addr-Current Ptr. 
into FDSS 


Char, Addr-End of FDSS 
storage 




FD 

i 


HT 








Hash Table 








48 Entries 




SZH 










3 words/entry 








144 words 




\ 


' 






FDHT 




+ SZH 


Corresponding Table 
144 words 




FDSS 


String Storage 
120 words 











Figure 22. File Directory Hash Table 



FILE DIRECTORY HASH TABLE 



When a user logs on, his file directory is read in from the 
disc. This file directory is then stored in a hash table in 
the user's TS page. Figure 23 shows the format for the 
3-word hash-table entries for magnetic tape, physical device 
and disc files. The three words consist of information 
abstracted from the file directory and pointers (character 
addresses) to the string storage table (FDSS). As an entry is 
inserted into the hash table (into FDHT+HN, where HN Is 
the hash number), the character string (ASCII file name) is 
stored into FDSS in the character address pointed to by 
FDCTLC. Therefore, the file names are put into FDSS chron- 
ologically. FDCTLC must then be updated by the number of 
characters in the file name. Word of the hash table entry 
contains the pointer (character address) into FDSS to the 
beginning of the character string. Word 1 contains the 
pointer to the end of the string. Word 2 of the hash table 
entry for any hash table is referred to as the "hash value 
word". Note that for disc file the hash value is the index 
block pointer. 

When the user's file directory hash table is created, the 
names of the physical devices that can be accessed as files 
are always inserted into the table. Note the hash table 
entry for a physical device. 



FILE DIRECTORY CORRESPONDING TABLE 

Three more data words, called the corresponding table entry 
and also indexed by hash number, are associated with every 
file. These three words consist of data abstracted from the 
file directory for storage in FDHT+SZH+HN and following, 
where SZH is the difference between the beginning of the 
hash table and the beginning of the corresponding table. 

The creation date of the file is set to the current data each 
time it Is opened as an output file. The field "No. of 
Accesses" Is Incremented each time the file Is opened for 
input or output. 



BRS 5 AND 6 



BRS 5 Is used for two operations: 

1. to look up an entry for o particular character string 
already In the hash table. 

2. to find where in the hash table a new character string 
should be inserted. 

The input for the first operation consists of pointers to the 
character string and to the address of the control table of 
the hash table that is to be searched. The output is the 
address of FDHT+HN ( where FDHT Is the address of the hash 
table) in B, and the value word (i.e., the 3rd word of the 
hash table entry) In A. 
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MagneHc Tape 



CB 


FT 


Poinfer 


LTP 


To File name 


HTP 





(32K) FS (Value) 



23 56 8 9 
Physical Device 



23 



1 





Pointer to 





File name (in "FDSS" table) 


1 


2 


3 


4 





DN 



23 5 6 
Disc File 



9 11 12 



19 20 23 



2 


FT 


Pointer 





To File name 


Index block pointer 
1 1 



FT File type 

LTP Low order tape position 

HTP High order tape position 

FS Tape file size 

FL File length for disc files 

C Change in file length 

CB File control bits 

= Tape file 
2 = Disc file 

DN Executive device number for the six built- 

in files 



23 5 6 

Corresponding Table Entry 



23 



c 





FL 


Account No. 


No. of accesses 


Creation date 


Month 


Day 


CB 


FT 


LTP 

1 


Future controls 

1 1 



23 5 6 8 9 11 12 14 15 17 18 23 



Figure 23. Hash Table Entry and Corresponding Table Entry for File Directory 
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Example: 

Get the index block pointer for a disc file named /JOHN/. 
Also, increment the number of accesses which is stored in 
the 3rd word of the corresponding table. 



NAME 



ASC '/JOHN/' 



PTRB 


DATA 


(R) NAME-1 


PTRE 


DATA 


(R) NAME+5 




LDA 


PTRB 




LDB 


PTRE 




LDX 


-FDCTL 




BRS 


5 




BRU 


BAD 




STA 


IBP 




CBX 






LDA 


SZH+1,2 




CLB 






LRSH 


9 




ADD 


= 1 




LSH 


9 




STA 


SZH+1,2 



Address of control 
table for File Direc- 
tory Hash table 

String not in table 
Value word is index 
block ptr. 

Get 2nd word of 
corresponding table. 



For the second operation — to find where in the hash table 
a new character string should be inserted — the BRS 5 will 
perform the hashing algorithm on the string and get a hash 
number. If the entry is already in use, the hash table will 
be searched backward until an available slot is found. The 
value FDHT+HN (address for insertion into the hash table) 
will be stored into the third word (working cell) of the hash 
control table. If there are no available entries in the hash 
table, the working cell will contain -1. BRS 6 Is used to 
insert the string pointers into words and 1 of the hash 
table once BRS 5 has determined where the hash table 
entry should be placed. The BRS 6 does not move the 
string into FDSS. 

Example: 

Insert a new file name Into a hash table. Refer to Figure 21 



NAME 


ASC 


'/NEW/' 


PTRB 


DATA 


(R) NEW-1 


PTRE 


DATA 


(R) NEW+4 




LDP 


PTRB 




LDX 


-FDCTL 




BRS 


5 




BRU 


S+2 




BRU 


BAD 



SKN 

BRU 

BRU 

BRS 

CBX 

BRM 



FDCTL2 
$+2 
BAD 
6 

XPHT 



Working eel I ~ -1 ? 

Hash table is ful I 
Make entry 

This routine inserts 
words into the hash 
and corresponding 
tables. 



LDP 


PTRB 




LDX 


FDCTLC 


FDCTLC points to 
next available space 
in FDSS 


BRM 


INSERT 


This subroutine will 
insert the character 
string into FDSS 


LDA 


FDCTLC 




ADD 


=5 




STA 


FDCTLC 


Update pointer since 



5 characters in 
/NEW/ 



COMMANDS HASH TABLE 

The entry for the Commands Hash Table is shown In Figure 24. 



Word 



Word 1 



Word 2 



Beginning String Pointer 



Ending String Pointer 



A 





B 


C 


D 


Address 



12 3 4 



A Command requires system status 

B Command requires operator status or above 

C Command requires subsystem status 

D Command requires a carriage return confirmation 

Address The virtual address of the routine that pro- 

cesses this request (command) 



Name should not be 
In table. 



Figure 24. Commands Hash Table Entry 



The commands and subsystem hashing tables ore initialized 
after the Executive has been assembled. This Isaccomplished 
by loading the new version of the Executive and also load- 
ing a file called INTLE. The INTLE file Includes a routine 
named SYSIN and two arrays named CIT and SIT which con- 
tain the information necessary to form the commands and sub- 
systems hashing tables. The SYSIN routine uses the BRS 5 
and 6 to Insert the information provided by the CIT and SIT 
arrays Into tioshing tables which ore in the Executive. 
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Commands Hash Table 



A macro named IT is used to generate the CIT array. A 
macro named SUBIT forms the SIT array. 

IT forms the ASCII string for each command, followed by 
several data words. The exact number of data words formed 
depends on the number of parameters in the macro call. 
Presently, there are at most 2 arguments which will produce 
2 data words. 

The IT macro provides the following data words for each 
command: 



Word to 
Word N 



1st Data 
Word 



2nd Data 
Word 



The internal ASCII command name 
terminated by a / 







23 



A 





B 


C 


D 


Address 



12 3 4 5 



23 



23 



See Figure 24 for description of 1st Data Word. 

Note that bit 9 of the 2nd data word is 0. This indicates 
that there are no data words generated for the SYSIN rou- 
tine to insert into the corresponding table. 



SUBSYSTEM HASH AND CORRESPONDING TABLE 

The Subsystem Hash Table and Corresponding Table entries 
are shown in Figure 25. 



Hash Table Ent 
Word 

Word 1 

Word 2 

Corresponding 

Word - 


ry: 




T 


V 


Begin String Pointer 




15 6 23 




LS 


End String Pointer 




5 6 23 




E 


u 


C CL 


RA 


HS 




12 3 8 9 15 16 23 
Table Entry (Non-reentrant Subsystem 


s) 





NP 


LOS 




5 6 9 10 23 





Word 
Word 








1 









23 




2 


RSW 






23 




Corresponding Table Entry (Reentrant Subsystems) 


Word 
Word 
Word 





Rl 






23 




1 


R2 






23 




2 


RSW 






23 




T 


test bit 


V 


version ID 


LS 


low-order bits of the starting address 


HS 


high-order bits of the starting address 


E 


propagate Executive status 


U 


cannot co-exist with user's memory 


C 


common (reentrant) subsystem 


CL 


class (must agree with user's control parameters) 


RA 


location on RAD for the subsystem. Applies 


only to the non-reentrant subsystems, since the 


reentrant subsystems have SMT entries. 


NP 


number of pages for a non-reentrant subsystem 


LOS 


load starting address 


RSW 


relabeling status word 


Rl 


first pseudo-relabel ing word 


R2 


second pseudo-relabel ing word 



Figure 25. Subs"''stem Hash Table and 

Corresponding Table Entries 



Figure 25. Subsystem Hash Table and 

Corresponding Table Entries (cont. ) 

The subsystem hash table is in page 1 of CMNDS and is 
labeled SYSHT. The corresponding table Is labeled SYSCT, 

The 5LJBIT macro form<; the ASCII string for the name of the 
subsystem followed by five data words. Subroutine SYSIN 



Subsystem Hash and Corresponding Table 43 



inserts the five data words into the hash and corresponding 
tables. 

The SUBIT macro produces the data words shown in Figure 26 
for each subsystem. 



USER BRSs FOR FILE MANIPULATION 

A program may open a disc file and obtain a file number by 
executing BRS 15 and BRS 16 (input) or BRS 18 and BRS 19 
(output). BRS 15 and BRS 18 require the file name from the 
teletype. If the name is known to the program, BRS 15 and 
18 may be replaced by BRS 48. These BRSs are used in the 
following way. 



LDA 



file 



BRS 15 (or BRS 18) 

EXCEPTION RETURN 

NORMAL RETURN 

The normal return leaves a file directory pointer, i.e., the 
location of the first word of the hash table entry (FDHT + HN) 
in A, and BRS 18 leaves the character typed after OLD FILE 
or NEW FILE in B, If no character was read, B contains a 
-1. The X register is modified, 

LDA file directory pointer 

LDX file type (BRS 19 only) 

BRS 16 (or BRS 19) 
EXCEPTION RETURN 
NORMAL RETURN 

The normal return leaves a file number in A, and BRS 16 
leaves the file type in B. X is modified. 

BRS 48 or 60 may be substituted for BRS 15 or 18. BRS 48 
is used if the name is in the file directory and BRS 60 will 
create a new name if necessary. 

LDP string pointers 

BRS 48 or 60 
EXCEPTION RETURN 
NORMAL RETURN 



Word 
to 
Word N 



1st Data 

Word 



2nd 



3rd 



^4th 



4th 



^5th 



5th 



The ASCII name terminated by a / 


23 


E U C 


CL 


RA 


HS 



12 3 8 9 15 16 23 



D(5) D(9) D(3) D(4)/100B 






V 


1 





LS 



5 6 89 10 17 18 23 

D(2) D(4)-HS 



RSW 







D(6) 




23 





NP 


LOS 



56 



10 



23 



D(8) 



Rl 





D(7) 


23 










23 


R2 







D(8) 



23 



generated for non-reentrant subsystems 



Figure 26. SUBIT Macro Data Words 
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13. EXECUTIVE COMMANDS RELATED TO FILES 



When a user logs on the system, his complete file directory 
is read from the disc and placed in the file directory hash 
table along with the names of the physical devices. The 
"LOGIN" procedure in described in the SDS Terminal Users 
Guide, 

The following executive commands are related to the user's 
file directory and are also described in the SDS Terminal 
Users Guide. 



1. 


FILES 


2. 


WRITE FD 


3. 


FD 


4. 


DELETE 


5. 


RENAME 



DELETE file is used to delete a file from the directory, and 
RENAME is used to change the name of a file in thedirectory. 

FILES causes the complete directory to be typed while FD 
types only a single entry. 

p, dt, s name 



Key 


Tape Files 


Disc Files 


P 

d 

t 

s 


Tape position 

(octal) 

Blank 

File type 
(1 through 4) 

File size 


Not used 

2 

File type (1 through 4) 
(1 through 4) 

Index block pointer 



A colon typed after FD or FILES of the above commands, 
will cause the length (in number of words) of a disc file to 
be typed out; the format is as follows where I is the length 

p, dt, s, I name 

Example: 

-FD:/DEMO/CR 
23, 512/DEMO/ 

Another feature of the system status typeout is that any con- 
trol characters In the file name will be typed out in two 
characters; the first character is the ampersand "&", For 
example, if the name of the file was /(bell)PROGRAM/, 
It would type out the message 

23, 12640/&G PRO GRAM/ 



The command "DF" can only be used by users with a special 
system status since It con create new file names while bypass- 
ing all system protection. The complete file parameters must 
be typed as follows 



DF 



lie name 



AS 



p, dt, s 



DF and AS are part of the command and are required for 
defining files. The disc file would be written In the follow- 
ing way. 



DF 



/file name/ AS 23, 10240 



An example of a tape file would be 

DF 'file name' AS 7,3, 10240 

The command "WRITE FD" causes the current file directory 
(as it appears in the file directory hash table) to be written 
on the disc. A description of the disc format Is given In 
Figure 13. 



MAGNETIC TAPE 

It Is possible to read and write files on magnetic tape. The 
system will also read and write BCD tapes (with a defined 
format). Only users with peripheral status can cause tape 
commands to be executed. Normally only one user should 
be accessing tapes at any given time and such use should be 
restricted to periods of time In which there are not more than 
two or three users on the system. 

All tape operations use an implied tape drive number of 0. 
This can be changed to 1 by typing the executive command: 

-STN 1 @ 

Under no circumstances should the same physical tape reel 
be used for recording both BCDTAPE files and standard 940 
files. 



BCD TAPE FILES 

Each file Is separated by an end of file (EOF) mark with two 
consecutive EOFs as the last recorded data on the reel. Input 
or output can begin at load point as file number 1. 

For input the system will read multiples of 3 character/ word 
up to 132 characters. If a record Is 79, 80, or 81 charac- 
ters long, the system assumes an 80 character record Is 
desired (card image). If the record is not a multiple of 3 
chorocter/word, zeros ore appended to the dote. 

For output, the records are written as either 80 or 13? 
character/word records. 
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The commands associated with BDCTAPE are: 



-COPY BCDTAPE TO /FILE/ @ 
START AT: N © 



-COPY /FILE/ TO BCDTAPE @ 
80 CHAR. REC? (YES/NO) @ 
START AT: N @ 



■BCDREW © 



BDCTAPE Input 

N = file position 
The default for 
N is the current 
tape position 

BCDTAPE output 

Default = 132 

N = number 
(Default is cur- 
position) 

Rewinds and positions 
to file 2. This com- 
mand should be used 
only on tapes which 
have at least 2 EOFs 
already recorded. 



File position is by EOF count only. For standard files, the 
software outputs a position word at the beginning of the file 
which indicates the position count. For more information 
on BCDTAPE format see Figure 20. 

STANDARD MAGNETIC TAPE FILES 

To write files on magnetic tape the tape must first be initial- 
ized. This is done with the operator's NEWTAPE program. 



This program causes the tape on drive to be rewound and 
3 dummy files will be written on the tape. Therefore, the 
first meaningful file on the tape will have a file position 
number of 4. 

A disc file can be placed onto tape by: 

-COPY /FILE/ TO 'FILE' © 

Note that the disc file /FILE/ is not affected by this opera- 
tion. There Is no confusion between the name /FILE/ and 
'FILE' because the slash or prime characters are stored as 
a part of the file name in the file directory. The copy oper- 
ation will cause an entry to be made in the file directory 
for the file 'FILE'. 

To copy files from tape to disc, the tape file directory entry 
must be in the file directory in use. If the tape file was not 
created by the user who wishes to copy It to the disc, (as is 
often the case) it will not be in the user's file directory. 
Therefore, the operator will type: 



-DF 'FILE' AS 4,3, 7640 
-COPY 'FILE' TO /FILE/ 
NEW FILE 



(see p, t, s) 



The choice of names for tape files is completely arbitrary. 
No file name identification Is carried with the file on the 
tape. See Chapter 9 for more information on the format of 
magnetic tape files. 



14. EXECUTIVE COMMANDS 



Table 5 gives a complete list of Executive Commands. 
Table 5. Executive Commands 



Table 5. Executive Commands (cont. 



The fol lowing 


commands are accepted by the executive 


for all users. 






LOGOUT 




Allows user to log out 


WRITE FD 




Write file director on disc 


RENAME 




Renames a file 


DATE 




Types date and time 


KILL PROGRAM 


Kills program relabeling only 


RESET 




Clears all of user's memory 


COPY 




Copies file to file 


FILES 




Types file directory 


FD FOR 




Types selected file directory entry 



GO TO 


Goes to o "GO TO" (type 1) file 


PLACE 


Places a "SAVE" type program (type 1) 




m core 


SAVE 


Save program; creates GO TO or type 




1 file 


BRANCH 


Branches Into a program 


DELETE 


Delectes a file 


TIME 


Types real time used 


STATUS 


Types user's relabeling status 


MEMORY 


Types user's unused memory 


" 


Causes typing to be ignored by EXEC 




Allows user to type comments 


DUMP 


Dumps all program, saves status 
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Table 5, Executive Commands (conf, ) 



Table 5. Executive Commands (cont, ) 



RECOVER 


Recovers from a DUMP file (type 4) 


CONTINUE 


Returns to subsystem being used before 




the return to Executive 


RELEASE 


Releases a subsystem 


EXIT 


Allows a user to LOGOUT without 




writing file directory 


ACCEPT 


Indicates the user is willing to be 


MESSAGES 


linked 


REFUSE 


Indicates the user is not willing to be 




linked 


LINK TO 


Allows a user to link to the operator or 




a particular account and user name 


Control D 


Cancels the effect of " 


(Joint pressinc 


) 


of CONTROL 




and "D" keys 


of 


the keyboard) 




BREAK LINK 


Allows a user to discontinue linking 


PMT 


Lists the PMT entries that a user has 




acquired 


The following 


commands are recognized by the Executive 


for users with 


operator status. 


SHUT DOWN 


Starts system shut down 


UP 


Cancels shut down 


HANG UP 


"Hangs up" selected teletype phone 




lines (DSS) 


ANSWER 


Answers (or enables) data subset 


WACCOUNTING Controls accounting to paper tape 


LETTER 


Types broadcast letters 


GFD 


Gets another user's file directory 


ENABLE 


Enables a subsystem group 


DISABLE 


Disables a subsystem group 


LOOK 


Looks at real core locations 


SYSLD 


Allows load from disc directly into 




user's core 


The following 


commands are recognized by the Executive 


for users with 


system status. 


USERS 


Types number of users on system 


WHERE IS 


Give teletype number for a user 


WHO IS ON 


Types users on system by account and 




name 


REWIND 


Rewinds tape, resets tape logic 


RLT 


Release tape 


STN 


Sets tape number 



PTN 


Types tape number 


SETEXED 


Sets user status 


POSITION TAPE Positions tape (not to be used on BCD | 




tapes) 


MTP 


Types current tape position 


DP 


Allows a file directory entry to be set 




up (see Chapter 13) 


REMOVE FILE 


Removes file from directory (without 




deleting) 


PSP 


Types error counters, etc. 


BCDREW 


Rewinds a BCD tape 


DBITS 


Prints the number of 256 word data 




blocks remaining in the disc bit map 


SMT 


Lists the SMT table entries 


The following 


commands are recognized by the Executive 


for users with 


subsystem status. 


RSMT 


Reads in from RAD a SMT Page 


SYSDP 


Allows core to be dumped directly on 




disc 


SSMT 


Sets the shared memory table 



LINK TO 



USER COMMANDS 



Account Number User Number or OPER 



This command allows a user to link to another user that is 
currently on the system or to the operator. If (") is typed, 
the Executive will ignore (not regard as a command) anything 
that is input until a control D is typed. This allows a user to 
converse with the user that he is linked to. If the link cannot 
be made at this time, the Executive will respond with one of 
the following messages: 

NOT ENTERED 

BUSY 

IN 8-LEVEL MODE 

NOT ACCEPTING LINKS 

Example: LINK TO F5103 

LINK TO OPER 

PMT 

Types the user's current Program Memory Table in the follow- 
ing format: 

aa DRMPOS: bb, cc (PAGE dd) 
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/here 



aa is the pseudo relabeling byte number, 

bb is the RAD address (shifted right three places). 

cc will type: RO for read only 

EX for Executive page 
DR for RAD page 

dd (if typed) will be the real page number in memory. 



SHUT DOWN 



OPERATOR STATUS 

(toggle switch 1 required) 



After the operator toggles console switch 1, the command 
will set a flag that initiates system shutdown. All lines 
that are not currently being used will be made unavailable. 
As soon as the users that are currently on the system either 
log off or hang-up, their teletype lines will be made 
unavailable, 

UP (toggle switch 1 required) 

After the operator toggles console switch 1, the automatic 
shut down flag described under SHUT DOWN is reset so 
that teletype lines are now available. The operator must 
re-answer (by using the ANSWER command) all lines that 
have previously been made unavailable. 



ANSWER 

k, m-n. 



(toggle switch 1 required) 



This command enables selected teletype lines for users. The 
operator may specify single numbers, indicated by "k", 
separated by commas, or a range of numbers where the range 
is separated by a dash, or any combination. Spaces are 
ignored; the string is terminated by a carriage return. If 
the line has already been enabled, the command will have 
no effect. Note that after the SHUT DOWN command has 
been issued, a line can be made available by this command 
but it will become unavailable after the user logS out. 



HANGUP 

k, m-n, , 



(toggle switch 1 required) 



The command has two functions; it may be used to hang up 
a user while he is logged in (in this case the line will go 
ready again after the hangup operation has been completed 
provided the SHUT DOWN command has been used), or it 
may be used to make a line unavailable if no one is cur- 
rently using the line. The format is the same as ANSWER, 



LETTER @ 
LETTER OFF/ON 
LETTER n 



(Response from Executive) 



This command has three functions and two formats. The 

second format, v/here a number n is typed after the 



command is used to type a broadcast letter, where n is the 
letter number from one to six. The operator can then inspect 
the text of any letter. 

The first format is used to control the transmission of broad- 
cast letters. If the letter switch is OFF no users will receive 
broadcast letters. If the letter switch is ON all users will 
receive the letters. The operator can add or delete letters 
using commands in/OPER/ program. 

While the operator is inserting a letter, the letter switch 
must be OFF, If the operator uses the first format of this 
command, the status of the letter switch will be reversed 
and the new status will be printed. 

Example: Assume the letter switch is on: 

-LETTER @ 

LETTER OFF The switch is now off 

-LETTER @ This will set switch on 

-LETTER ON 

When the operator adds a new letter, each user will receive 
the letter when he logs on. The users that are on the system 
while the letter is being added will receive the letter when 
they return to the Executive (escape to the part of the Exec- 
utive that types the -), 

WACCOUNTING n @ (Currently not implemented) 

After the CR is typed, the following message will type: 
TOGGLE SW. 1 @ 

The command will not be executed until console switch 1 Is 
toggled. 

If n = 0, accounting information being punched on paper 
tape when users log out will be stopped. 

If n = -1, DUnchina of the a<~'"'^iin1-inn informntinn nn nnner 
tape when users log out will be started. 



GFD 



aa nnnn @ 



The command is used by the operator to get a file directory 
belonging to another user for special background or non- 
timesharing processing. The operator's own file directory 
and user number is replaced by those belonging to the account 
number "aa" and user name "nnnn" although the operator's 
account number and control parameters are retained. Sub- 
sequent to issuing a GFD command, the operator must not 
Issue: RENAME, DELETE, WRITE FD, EXIT, or LOGOUT; 
otherwise, accounting misinformation will result, 

ENABLE s @ 
DISABLE s @ 



^here 



is the name of a subsystem in the group. 
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The subsysfems are: 

Group 1 - TAP, DDT 

Group 2 - Currently not used. 
LOOK 
This command is typed in the following format: 

LOOK a, n © 

a bbbbbbbb 

a+1 bbbbbbbb 

etc. 

This command allows an operator or system class user to 
display real memory addresses where "a" is the first loca- 
tion to be displayed (in octal) and "n" is the number of 
locations (in decimal) to be displayed. The format of the 
type out is as indicated in the example where "a" and "a+T 
are the octal addresses and "b" represents the contents in 
octal. 

SYSLD 

The command is typed in the format: 

SYSLD a © 

TO b @ 

LOC c © 

This command allows a user to load his program memory frorr 
any location on the disc into any of his eight pages, "a" 
and "b" refer to his page numbers (0 to 7) and "c" is either 
a real disc address or a number from to 7 referring to 
discs through 7, with the load starting at arm position 
63 of the given disc. Also, "c" may be formatted "n.m" 
where "n" is the disc number described above and "m" Is 
a number from to 7 referring to a relative page number 
of arm position 63. 



Arm position 



Disc n 



62 
n.O 
n. 1 
n.2 
n.3 



63 

n.5 

n.5 

n.6 

n.7 



SYSTEM COMMANDS 

USERS 

nn 

Types the number of users (nn) currently logged on the 
system. 

WHERE IS a a nnnnnnn 

XX 



By typing the account number ("aa") and the user's name 
("nnnnnnn . . . "), this command will type the current tele- 
type number ("xx") on the user. 

WHO IS ON 

XX aa nnnnnnn . . 
XX ss 

This command causes a complete list of the current TSS users 
to be typed where: 

XX teletype number 

aa user's account number 

nnnn . . user's name 



status of line. 



REWIND 



@ 



This command releases and rewinds the tope regardless of 
its current status. It is applied to the current tape num- 
ber (0 or 1). 

RLT @ 

This command releases the tape making it available to other 
users. 

STN n © 

Allows a user to specify the tape unit number (0 or 1). BCD 
TAPE operations will normally use tape unit unless 1 is 
specified by issuing this command. 

PTN © 

n © 

Types a user's current tope number (0 or 1). 
POSITION TAPE © 

This command will cause the current tape to move to the 
beginning of the next file. 

MTP ® 

Types the current tape position as far as is known to the 
Executive. This command does not check the actual position 
by reading tape. 



PSP 



This command types out symbols of the current system error 
counters. 

PSP 

TN 1 

TU 

TP\ 

T\A/ A 



Tape noise eiTors 
Unrecoverable read errors 
Tape read errors 
Tape write errors 
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PF 





DC 





D 





DU 





DF 





RC 





R 





RU 





12 





CP 





IP 





XB 





FD 





DO 





TD 


12 


IT 


n 



Power Failures 
Disc channel errors 
Disc controller errors 
Unrecoverable disc errors 
Disc failures 
RAD channel errors 
RAD controller errors 
Unrecoverable RAD errors 
RAD 12 interrupt errors 
CPU memory parity count 
I/O parity errors 
Map index block error 
File directory errors 
Teletype data overrun 
Duplicate teletype on interrupts 
Illegal teletype off interrupts 



SETEXEC 



e 



Sets one of the following classes of executivity if the user's 
status parameters allow the use of this class. The class set 
is then sent to any fork started by the system executive 
with the "GO TO" command. 



•1 



Sets system status 



Cancels system status 

REMOVE FILE nn, & 

This command allows a user with system or operator status to 
remove an entry from a file directory without using the 
DELETE command. Since it may not be possible to delete a 
file if the name contains leading spaces or other spurious 
characters, it may be required to use this command as a 
last resort. The command removes o file from the "in-core" 
directory by referring to the file name's position "nn" in 
the printed file directory. The FILES command must be 
given just prior to using this command in order to find the 



current relative position of the name. The file directory is 
NOT rewritten on the disc by this command. 

SMT 

This command lists the SMT entries. The format is the same 
as the PMT command, 

SUBSYSTEM COMMANDS 

SYSDP 

The command is typed in the following format: 

SYSDP a B 

TO b ® 

LOC c @ 

This command allows a user to dump his program memory onto 
any location on the disc from any selected pages of his 
eight pages of program relabeling. The format is the same 
as SYSLD, 

RSMT @ N (N-SMT pseudo-relabeling byte) 

This command reads an SMT page from the RAD if the page 
is currently in core. The purpose of this command is to 
read in a new copy of an SMT page in case the copy that is 
currently core-resident has been damaged or altered. The 
new copy will reside in the same core occupied by the old 
copy. This command is the same as the BRS BE+15. 

SSMT ® 

N DRMPOS: aaa, E, R 

N SMT pseudo-relabeling byte 

E Make page Executive (set bit 1 of SMT entry) 

R Make page Read-Only (set bit 18of SMT entry) 

aaa RAD address truncated by 3 bl ts (see output of 

SMT command) 

SSMT is used to set an SMT entry. E and R are optional. 
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SUBSYSTEM COMMANDS 



15. REENTRANT SUBROUTINE CALLS 



Since the Executive is reentrant, any instruction it executes 
that will alter memory will always reference the TS page. 
The TS page is in page of the Executive's relabeling. The 
BRM instruction must be used indirectly since it alters mem- 
ory by storing the return linkage into the effective address 
of the instruction. 

Assume the following is available to the Executive in the 
user's temporary storage page: 

LVLl ZRO 

BRR* LVLl 
LVL2 ZRO 

BRR* LVL2 

The Executive wishes to call subroutine SUBl which in turn 
will call a subroutine SUB2, 



EXC BRM* SUBl 



SUBIN BRR LVLl 

SUB2 ZRO LVL2 

BRR LVL2 

The instruction at EXC stores a markword at LVLl. LVLl + 1 
is executed as the next instruction. Since LVLl now con- 
tains EXC (the markword), the BRR* transfers control to 
SUBl + 1: 

((LVL1))+1 (EXC)+1 -SUBl +1 - P 

The BRR at SUBIN will transfer control to EXC+1: 

(LVL1) + 1 - EXC+ 1 -P 

The call at SUBIC will store the markword (SUBIC) at LVL2 
and the BRR* at LVL2+1 will transfer control to SUB2+1. 



SUBl ZRO LVLl 



SUBIC BRM* SUB2 



The word pairs (LVLl, LVLl + 1, etc.) are in the TS page 
from the CFIl through RLV4+1. They are initialized for 
each user when he is given his TS page. The coding which 
does the initialization is at TSONI. 



16. MISCELLANEOUS FEATURES 



A user may dismiss his fork for a specified length of real 
time by executing a BRS 81 with the dismissal time, in mil- 
liseconds, in A. At the first available opportunity after 
this time has been exhausted, his fork will be reactivated. 
The contents of A are changed, 

A user can read the real-time clock into A and the system 
start-up date and time into B by executing o BRS 42. The 
number obtained increments by one every l/60th of a sec- 
ond. An Executive fork can read the elapsed time counter 
for the user into A by executing a BRS 88. This number is 
set to when entering the system and increments by 1 at every 
l/60th second clock interrupt while the fork is running. 

To obtain the date and time, the user can execute a BRS 91. 
This string pointers in the A and B registers. The string 
contains In order, the month/day, hour (0-23) and minute 
at which the instruction Is executed. 



A fork tests whether it Is Executive or not by executing a 
BRS 71. The type of Executlvlty Is returned in B. If B equals 
1, the fork is subsystem. If B equals 0, the fork is user. If B 
equals -1, the fork Is system and subsystem. If B equals -2, 
the fork is system. If B Is negative, BRS skips on return. 

An Executive fork can dismiss Itself explicitly by executing 
o BRS 72 (see Chapter 2). 

There are two operations designed for Executive BRSs which 
operate in the user mode with a map differing from the one 
they are called from. BRS 1 1 1 returns from one of these 
BRSs, transmitting A, B, and X to the calling fork as it finds 
them. BRS 122 simulates the addressing of memory at the 
location specified In A. If new memory is assigned, It is put 
Into the relabeling of the colling fork. If memory panic 
occurs, it appears to the calling fork that it comes from the 
BRS Instruction. 



A user ma^' dismiss a fork until an interrup 
fork is terminated by executina a BRS 109. 



/-^n L.xecuiive i^rK >_un cousc un insiruciion lo ue eAC(_uieo 
in the svstem mode by addressinn it with EXS. 



Reentrant Subroutine Cal Is/ Miscellaneous Features 



There are switches in the Monitor that can be set by an 
Executive fork with a BRS BE+13, It takes the new switch 
value in A and the switch number in X. It returns the old 
switch value in A. 

An absolute location in the Monitor relabeling can be read 
or changed by an Executive with a BRS BE+4. The absolute 
location is in X, the new value, if any, in A. The BRS 
reads if B is positive and changes the word if B is negative. 



An Executive fork can also force a new page to be read from 
the RAD with a BRS BE+15, It requires an SMT pointer in A, 

An Executive fork can test the state of any breakpoint switch 
with a BRS BE+7. The switch number is in X, The BRS skips 
if the switch is down. 

An Executive fork can crash the system with BRS BE+8. A 
fork can set Executive status with a BRS BE+1 6 and 7654321 OB 
in the A register. System status is required. 



17. UTILITY PROGRAMS 



DSWAP 

DSWAP is a self-loading utility program, usually stored on 
magnetic tape, that initializes the TSS system. It performs 
the following functions: 

1. If breakpoint 1 is reset, the first 32K of core is written 
onto discs and 1 in arm positions 62 and 63, If break- 
point 1 is set, the current contents of core are not 
written onto disc. 

2. The first 14K of the Monitor is loaded into core from 
arm positions 62 and 63 of the disc selected by break- 
points 2 through 4. 

Copies of the monitor can be stored on discs 2, 4, 
and 6, 

The three breakpoint switches are regarded as repre- 
senting a binary number between and 7. Therefore, 
to load the system from disc 2, breakpoint 3 would be 



The specific programs provided are not used as often as the 
functions which are available through system Executive. 
Therefore, the program is initiated with a GO TO type 
statement and is normally the operator's file directory. 

CONTROL COMMANDS 

The program has a simple command dispatcher that indicates 
it is ready to receive a command by typing an asterisk. In 
order to reduce operator error, the commands must be typed 
completely. Each command is described in detail in this 
chapter and the commands are listed by category with a 
brief description in Table 6. 

GENERAL OPERATING INSTRUCTIONS 

The operator calls the program by typing 
GO /OPER/ (g) 



After the monitor is loaded, DSWAP halts at location 24B . 
When the halt is cleared, a branch occurs to a portion of 
the Monitor which has just been loaded. The system exe- 
cutes a transfer from 930 to 940 time-sharing mode and the 
remaining 4K of the Monitor is read into core. 



OPER PROGRAM 

The general function of the OPER program is to provide the 
operator with information or control of the following per- 
manently assigned areas of the disc: 

o File directories. 

o User/Account directory. 

o Accounting data storage area. 

o Broadcast leter area. 



/OPER/ is the name of the program. 

* which is typed by the program, indicates that the 
program is ready to receive the first command. 
The typed command is then followed by a carriage 
return or a linefeed if appropriate. 

@ Generally the carriage return confirmation 
indicates to the program that the complete output 
is desired. There is also a linefeed (©) command 
which indicates that a selected output (for a par- 
ticular user number in case of the file directories 
or for a particular account number in case of the 
user account directories) is desired and that a user 
number or account number will be supplied as 
appropriate to the command. 

If an invalid command is typed, the program will respond 
with a question mark and type the asterisk, indicating that 
the program is ready for another command. 
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Table 6. Control Commands 



COMMAND 


DESCRIPTION 


FILES 

CLEAR FILE 

TIME 

RESET TIME 

SET DAY 

SET HOUR 

LENGTH 

SIZE ACCOUNT 

GARBAGE 

POINTER 


File Direcfories 
Outputs all or selected file directories. 
Clears a selected file directory. 

Outputs the user's real and computer time as carried in the file directory. 
Same as time but also clears the time words to zero. 
Validates all or selected users for 24 hour/day. 
Validates all or selected users for any selected time. 
Computers length of all files by account number. 
Uses length output to compute maximum storage used. 
Removes unused areas from the overflow file directory area. 
Indicates next available overflow storage area. 


UAD 

ACCOUNT 

NAME 

CANCEL ACCOUNT 

CANCEL NAME 


User Account Directory 

Outputs all or selected user/account directories. 
Creates a new account or changes an account password. 
Creates a new user name or changes a user name. 
Cancels an account directory. 
Cancels a user name out of a user/account directory. 


COPY RECORDS 
CLEAR RECORDS 


Accounting Storage 

Copies accounting records to a file. 

Copies accounting records to a file and then clears the accounting storage area. 


COUNT LETTER 
REMOVE LETTER 
LETTER 


Broadcast Letter 


Counts the number of users who have not received each of the six broadcast letters. 
Allows the operator to remove a broadcast letter. 
Allows the operator to create a broadcast letter. 


HELP 


MIscel laneous 
Lists all of the operator executive routine commands. 



PROGRAM LOADING AND ASSEMBLY PROCEDURE 



OPERATOR EXECUTIVE ROUTINE 



The progrom consists of two symbolic files, usually called 
/OPl/ and /OP2/. The first file is assembled by TAP in 
the usual manner while the second file is assembled using 
the CONTINUE command to the Executive since it uses con- 
stants contained in the first file. Both binary outputs are 
loaded using the DDT command ;T, and the program is then 
ready to run, starting at location 240B. Normally a pro- 
gram Identifier is placed at location 237B so that the pro- 
gram Is saved from 237B to the final address (as typed by 
DDT) with the starting address as 240B. 



The following paragraphs describe all the commands con- 
tained in the operator Executive routines program. The com- 
mand is shown along with the appiopiiate terminafoi. 



'he 



'c' only the carriage return is appropriate 
';0 only the linefeed Is appropriate 
/ >,'_' either carriage return or line feed Is appropriate. 
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The function of the command is then described, followed by 
the operating instructions; if any messages are typed by the 
program, the messages are then shown along with the appro- 
priate action to be taken by the operator. Actual example(s) 
of the use of the command is then shown along with a typi- 
cal output, if any. In the examples, underscored copy 
represents copy produced by the system. Unless otherwise 
indicated, copy that is not underscored in an example must 
be typed by the user. Following the example an output des- 
cription is supplied if appropriate. 

Note: The outputs and inputs, if any, of all commands are 
symbolic files except for the COPY RECORDS and 
CLEAR RECORDS which supply binary (type 2) out- 
put files. This means that the comment OUTPUT 
FILE includes the physical devices such as the 
printer and teletype, except for the COPY REC- 
ORDS and CLEAR RECORDS commands. 

ACCOUNT 

COMMAND: ACCOUNT @ 

FUNCTION: Creates a new account or changes an account 
password in the account user directory. 

After giving the command the operator types the account 
number and the password, terminated by a carriage return. 
This will either create a new password or change an old one. 
The operator types the account parameter words, separating 
each parameter by a space, and terminating the list with a 
carriage return. 

Examples: 

*ACCOUNT © 
BIXYZ 

@/© 



'here 



"Bl" Is the account number 

"XYZ" is the password, 

set the account parameters to zero. The 

account parameters are currently not used by the 
system. However, they must be supplied for the 
command to work properly. 

This command may be used to change more than one account. 
Note that after the operator types the new account param- 
eters he may respond with either a line feed or carriage 
return. A carriage return Indicates that the operator does 
not wish to change more accounts. The line feed allows 
another account to be changed. 

^ACCOUNT @ 
A 1 PASS @ 

© 



A2PASS © 

© 

* 

CANCEL ACCOUNT 

COMMAND: CANCEL ACCOUNT © 

FUNCTION: Cancels account password and user names from 
an account directory. 

After giving the command terminated by a carriage return, 
the operator types the account number followed by a carriage 
return. The program will then type the asterisk. 

Examples: 

*CANCEL ACCOUNT © 

Bl ©/© 

Several accounts may be canceled by terminating the account 
number with a line feed. 

*CANCEL ACCOUNT 

C5 © 

A8 © 

B7 @ 

CANCEL NAME 

COMMAND: CANCEL NAME © 

FUNCTION: Cancels a user name out of a user account 
directory. 

After giving the command terminated by a carriage return, 
the operator types the account number and user name, fol- 
lowed by a carriage return. If the name is located, the 
program wll I type 

OLD 



completing the operation. If the name cannot be located, 
the program will type 

NEW 

INVALID USER 



and the operator may then correct the name. 
Examples: 

*CANCEL NAME © 
BIJONES © 
OLD 
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The command can be continued if the operator wishes to 
cancel more than one name. Note that either a line feed 
or carriage return can follow the account and user name. 

* CANCEL NAME @ 

A2BET © 

OLD 

A3CET ® 

OLD 

* 

CLEAR FILE 

COMMAND: CLEAR FILE © 

FUNCTION: Clears a selected file directory. 

The operator types the user numbers for the file directories 
that are to be cleared. The command must be terminated 
by typing a user number that is greater than the last valid 
user number. Normally the operator will terminate by 
typing 7777 and the program will respond with the message 

END OF JOB. 

Examples: 

*CLEAR FILE © 

234 ® 

416 @ 

7777 @ 

END OF JOB 

This command does not clear the bit map. The MAP pro- 
gram must be run in order to update the bit map. 

CLEAR RECORDS 

COMMAND: CLEAR RECORDS @ 

FUNCTION: Copies accounting records to a file and then 
clears the accounting storage area. 

After the operator has given the command, the program will 
ask for an output file; this file cannot be a physical device 
such as the PRINTER or TELETYPE since the output is binary 
(type 2 file). If a satisfactory file name Is given, the pro- 
gram will write the accounting records to the file and return 
to the asterisk. If a bad file name Is given, the program 
will ask for the output- file again. 

Examples: 

*CLEAR RECORDS (§) 
OUTPUT FILE: /ACCT/ @ 
NEW (OLD) FILE @ 



COPY RECORDS 

COMMAND: COPY RECORDS ® 

FUNCTION: Copies accounting records to a file. 

After the operator has given the command, the program will 
ask for an output file; this cannot be a physical device such 
as the PRINTER or TELETYPE since the output is binary(type 
2 file). If a satisfactory file name is given, the program will 
write the accounting records to the file and return to the 
asterisk. If a bad file name is given, the program will ask 
for the output file again. 

This command outputs the account number, user, name, con- 
nect time, and CPU time. It then calculates the maximum 
amount of disc storage used and prints it with the above 
information. 

Examples: 

*COPY RECORDS @ 

OUTPUT FILE: /ACCT/ @ 

NEW (OLD)FILE @ 

ACCOUNTING DATE (M-D): 5-27 

COUNT LETTER 

COMMAND: COUNT LETTER @ 

FUNCTION: Counts the number of users who have not 
received each of the six broadcast letters. 

The operator merely gives the command terminated by a 
carriage return; the program will then give the count in the 
following format: 



1 





2 


975 


3 





4 





5 


1024 


6 






where the number in the left column is the letter number and 
the number in the right column Is the number of users who 
hove not received the letter (0 indicates the letter is not 
being used and 1024, as for letter number 5, Indicates the 
letter has not been released). The letter program Is cur- 
rently Implemented for a maximum of 1024 users. 



FILES 

COMMAND: 
FUNCTION: 



FILES @/© 

Provides to an OUTPUT FILE the complete or 
selected file directories. 
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If the command is followed by a carriage return (Figure 27) 
the program will ask for the output file by typing OUTPUT 
FILE:. The operator may then type any appropriate output 
file name. If a wrong file name is supplied the program 
will again type the message OUTPUT FILE:. The normal 
output file will be the printer since the output may exceed 
the capacity of disc files. The message END OF JOB will 
be typed when the last file directory has been printed. The 
output begins with user number 1 and continues for all the 
valid user numbers on the system. If a particular user num- 
ber has an overflow file directory associated with it, the 
overflow directory will be listed immediately following the 
user's first directory. 

When the file directory for the last user number has been 
printed, all of the overflow directories should have been 
printed. If any overflow directories remain (were not ref- 
erenced by a user number), they will be supplied at the end 
of the listing under the title LOST OVERFLOWS. 

If the command is followed by a line feed (Figure 28), the 
program assumes the output file will be the teletype. The 
operator must type the user numbers for the file directories 
desired. When a user number is typed that is greater than 
the last valid user number, the program will type END OF 
JOB and terminate. 

OUTPUT DESCRIPTION 

Typical output has the following form: 

211 0:00.51 0:15 77777777 

1500107 2 23000000 31 176/CONVERT/ 

where 

21 1 user number 

0:00.51 hours, minutes, and seconds of com- 

puter time. 

0:15 hours and minutes of real time used (since 

reset time). 

77777777 Valid on-time where each bit represents 

an hour of the day. The left-most bit represents 
00:00 to 01 LOO. 

15 Account number (where 15 would be accountA5), 

00 Number of times the file was access since last 

disc re-ordering. Reaches a maximum of 77B and 
stays there. 

107 Creation date, where high order 4 bits is month 

less one and low order 5 bits is day of month less 
one. Example of 154 is April 13. . 

60000000 (would appear instead of the 2) Flag bits 

indicating file was written on. ^ 



'^These bits are used by the concurrent tape back-up routine 
and the disc file re-ordering routine. 



-GO /OPER/ 








♦FILES 








OUTPUT TO: 


TKI.ETyPE 






k/17 15:13 






1 35:^^.56 1365:59 77777777 


} 


125127 


6 


21000000 


42423 MI6 


101140 


60000000 


24000000 


41212 /«/ 


123^51 


42 


21000000 


35307 /TAP/ 


102000 





3730000 


7640 'B' 


123113 


2 


21000000 


1277 WSD 


12312if 


22 


21000000 


2521 /F2C/ 


1230^7 


12 


21000000 


15332 /Cri'N3/ 


123046 


12 


21000000 


15320 /FIO/ 


123451 


21 


21000000 


41311 /QED/ 


123122 


32 


21000000 


52464 /F2R/ 


123047 


12 


21000000 


21304 /CFTN2/ 


123451 


22 


21000000 


41332 /DDT/ 


123047 


30 


21000000 


21316 /CFTNl/ 


144152 


40000000 


21000000 


4l471 


125132 


60000000 


21000000 


1324 /GAL/ 


101147 


60000000 


21000000 


630 /WSD/ 


177130 


40000000 


21000000 


31366 /REG 0/ 


. 146451 


2 


21000000 


55336 NEWTAPE 


102134 


60000000 


23000000 


1166 /W@/ 


100127 


21 


21000000 


53200 /BACKUP 0/ 


OVERFLOW: 


2232 






2232 0:00 


.00 0:00 






100454 


12 


21000000 


13466 /XFIO/ 


124451 


40000000 


21000000 


45314 /BASIC/ 


124047 


32 


21000000 


25306 /CFTN4/ 


OVERFLOW: 


1 






2 0:38.28 55:37 77777777 




100113 


2 


22000000 


33302 /@/ 


100113 


12 


21000000 


37307 /CTRDP®/ 


100050 


12 


21000000 


7507 /@CFTN2/ 


100113 


21 


21000000 


33304 /QED®/ 


100050 


31 


23000000 


77461 /@X/ 


100113 


22 


21000000 


33325 /DDW 


100013 


3 


23000000 


7274 /SZ@/ 


100046 


12 


21000000 


3665 /6FI0/ 


102010 


40000000 


21000000 


170 /@XWSD/ 


100050 


30 


21000000 


60246 /@CFTN1/ 


101132 


60000000 


41000000 


77556 /@CAL/ 


101152 


60000000 


21000000 


55365 /OPEX/ 


100113 


52 


24000000 


37321 /SST@/ 


100001 


2 


21000000 


73574 /NEWTAPB@/ 


100113 


2 


23000000 


43333 /CONTRS®/ 


100050 


70 


23000000 


7664 /18@/ 


100050 


32 


21000000 


7521 /@CFTN4/ 


100113 


22 


21000000 


53305 /F2C@/ 


101001 


40000000 


21000000 


73576 /Ml6@/ 


OVERFLOW: 


2304 






2304 0:00 


.00 0:00 






100113 


42 


21000000 


47303 /TAP®/ 


100113 


21 


21000000 


53327 /PLOP®/ 


100113 


32 


21000000 


57322 /BAXIO®/ 


100113 


12 


21000000 


57310 /XFIO®/ 


100050 


12 


21000000 


13513 /®CFTN3/ 


100113 


32 


21000000 


73152 /@F2R/ 


OVERFLOW: 


2 






3 0:25.43 33:07 77777777 




lo6l4o 


60000000 


23000000 


55762 /DUMP®/ 


106152 


6 







Figure 27. FILES Command Terminated by a Carriage Return 
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-GO /OPER/ 








*FILES 








Vl7 15:09 






426 








kzS 3:12. 


.36 333:12 


77777777 




30^152 


60000000 


23000000 


52765 /SDS/ 


321151 


60000000 


23000000 


56726 INV 


30215^ 


60000000 


23000000 


23013 /ANN/ 


322143 


60000000 


22000000 


71222 2 


356152 


60000000 


23000000 


1301 /UMASTER/ 


301142 


60000000 


23000000 


55147 /MASTER®/ 


313152 


60000000 


23000000 


6570 /DDTP/ 


377152 


60000000 


23000000 


21367 /MASTER/ 


302143 


40000000 


21000000 


22154 BB 


305143 


60000000 


23000000 


55164 U 


302157 


60000000 


23000000 


4777 /STOCK/ 


303157 


60000000 


23000000 


5104 /LIBRARY/ 


300125 


40000000 


22000000 


ll4l /SORT/ 


307143 


60000000 


22000000 


5244 /BNUPD/ 


3:;ii52 


60000000 


23000000 


36475 /SCTP/ 


302131 


5 


23000000 


62710 /ACNG PRO/ 


302123 


4 


23000000 


41202 F 


304l42 


60000000 


23000000 


40347 /MASTERl®/ 


306057 


40000000 


21000000 


56472 AA 


OVERFLOW: 


2213 






2213 0:00 


.00 0:00 






313152 


60000000 


23000000 


41206 /OOS/ 


310143 


40000000 


21000000 


22073 LIBUPDATE 


311142 


40000000 


21000000 


35257 LIBSORT 


302122 


2 


23000000 


21125 /TOP/ 


304131 


27 


23000000 


31261 /ZZZ@/ 


301144 


60000000 


23000000 


72147 /AD/ 


303152 


60000000 


23000000 


53001 /FORT/ 


300131 


27 


23000000 


51136 /YYY/ 


3l4l43 


60000000 


23000000 


5242 /NUPD/ 


314152 


60000000 


23000000 


11613 /TOT/ 


313152 


60000000 


23000000 


41210 /FLTP/ 


3031^7 


60000000 


23000000 


50751 /RESUME/ 


306155 


60000000 


2300000vO 


26302 /./ 


OVERFLOW: 


426 






231 








231 0:0C 


).31 0:11 77777777 




2202140 


60000000 


23000000 


25664 /USCl/ 


2202140 


60000000 


23000000 


25671 /USC2/ 


7777 








TOTAL: 3:12.68 333:23 




END JOB 









Figure 28, FILES Command Terminated by a Line Feed 



2 File size where each bit represents one data block 

of 255 words 

23000000 File type (23 means symbolic disc file) 

31176 Index block pointer (or file size for magnetic 

tape). 



/CONVERT/ Name of file (control characters are 

Drpcedet 
printer). 



Dreceded hv nn R, rin fhp *-f»lp*-vnfi r,r k\/ rt A Qi-i fhe 
1 "/ ■ — - - •"•-•/I — ~ ~/ " " " 



GARBAGE 

COMMAND: GARBAGE @ 

FUNCTION: Removes unused overflow areas from the 

overflow directory area and makes the area 
available for use. See Figure 29, 

The program first determines the current location of the 
overflow pointer; in other words, it finds the next available 
overflow area. This is typed out as follows where nnnn is 
the pointer: 

OVERFLOW POINTER AT: nnnn 

The program next types the following message: 
GARBAGE COLLECTION READY TO START. 
ONLY 1 USER ALLOWED ON SYSTEM. 
"ESCAPES" WILL BE INHIBITED. 
TYPE @ TO CONTINUE. 

The program pauses here until a confirming carriage return 
is typed by the operator. Since this program cannot be run 
if any users except the operator are logged on the system, 
the program next checks the number of users on the system. 
If more than one user is on the system the following message 
is typed, followed by a return to the EXEC: 

MORE THAN 1 USER ON. 

If the operator is the only user, the following message is 
typed: 

GARBAGE COLLECTION STARTED, 

The program will proceed with no further messages until the 
garbage collection has been completed. At that time it will 
again determine the location of the overflow pointer and 
type the message: 

OVERFLOW POINTER AT: nnnn 

The difference in the pointers will indicate the gain in over- 
flow directory storage area due to the garbage collection. 
The message END OF JOB will then type and the operator 
will be forced to EXIT from the system so that his new file 
directory overflow pointer on the disc will not be destroyed. 
The operator should then take the system down and take a 
disc dump to save the new file directory arrangement, 

HELP 

COMMAND: HELP @ 

FUNCTION: Lists all of the commands the operator Execu- 
tive routine will recognize. 

LENGTH 

COMMAND: LENGTH©/© 

FUNCTION: Outputs the amount of disc storage used by 
the account number. 
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Before GARBAGE 










After GARBAGE 






(1100) i^ 


sov 


(1100) ^' 






Em 


pty 


















Empty 






(1351) y 


r 










(1352) Used 












(1353) Used 

(1354) Empty 




















(1355) Used 










(1355) ,r 








(1356) Use^ 


i 


k 


(1356) '^ 




Us 


ed 


















(1371) Used 










Used 




(1372) Empty 












(1373) Empty 














(1374) Used 

(1375) Empty 
























(1376) Used __ 












(1377) Used 


LUNG 


(1377) 


1 




Note: Overflow file directory organization before and after running the GARBAGE command. The numbers in 


parentheses represent the overflow file directory user number. 





Figure 29. Garbage Collection 



If command is terminated by carriage return, the program 
asks for an output file by typing OUTPUT FILE:. The 
operator should then type any appropriate output file 
name. If a bad file name is supplied, the program wil 
type the message OUTPUT FILE: again. The message 
END OF JOB will be typed when the last user's file 
directory has been processed, and the output file has been 
closed. 



If command is terminated by line feed, the program asks for 
an output file as described in the previous paragraph. The 
operator must type a user number for each file directory (and 
each overflow directory for which size he desires. The oper- 
ator types a user number greater than the last valid user num- 
ber (normally 7777), to terminate the list of user numbers. 
The disc storage by account for the selected user numbers 
will then be output as in paragraph 1. 
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LETTER 

COMMAND: LETTER @ 

FUNCTION: Allows the operator to create a broadcast 
letter. 

Before giving this command, the operator must first set the 
EXEC letter switch to OFF, This is done by giving the 
EXEC command LETTER @. The EXEC will respond with 
LETTER OFF. Then the operator may GO TO the operator 
program and give the LETTER command. The program will 
respond with: 

LETTER NO.: 

and the operator must respond with a number from 1 to 6, 
corresponding to the letter that he wishes to create. The 
operator should then type a carriage return (after the letter 
number) and normally should type another carriage return 
so that the letter starts at the left edge of the paper. The 
operator should then type the letter and terminate with a 
control "D", theE.O.T. character. If the operator makes 
a mistake and would like to delete the character just typed, 
he may type a * sign; one character is deleted for each 
pound sign typed. When the operator has typed the control 
D, indicating end of letter, the program will respond with 
the asterisk. The operator must then return to the EXEC 
and type LETTER again. The EXEC will respond with LET- 
TER ON and the new letter will be typed for the operator. 

EXAMPLE: (starting from the EXEC) 

-LETTER © Giving the EXEC command to turn 

the letter switch off. 

LETTER OFF 

-GO /OPER/ © Calling the OPER program 

*LETTER © Giving the command 

LETTER NO. : 2 © The program asks for a letter 

number 

© © © 

TEXT OF LETTER © © The letter; maximum 

size is 189 characters 

D = 

-LETTER 2 © EXEC command to type a letter 

TEXT OF LETTER EXEC types the letter 

-LETTER © Turning the letter switch on 

-LETTER ON 

TEXT OF LETTER The operator and everyone cur- 

rently on the system receives the letter when they 
come back to the Exec. 



NAME 

COMMAND: NAME © 

FUNCTION : Creates a new user name, changes a user 
name In an account/user directory, or 
changes the parameters for a user. 

After giving the command, terminated by a carriage return, 
the operator types the account number and the user name, 
followed by a carriage return. The program will respond 
with one of the two following messages: 



OLD 



NEW 



indicating that the user name is new (not presently in the 
account user directory) or old (already in the account direc- 
tory). If OLD is typed, the operator may continue if he 
desires to change the parameters. The operator types the 
parameter wcr d, terminated by a carriage return. Note that 
the parameter word must contain the user number in the low 
order 12 bits and the user's control status in the high order 
12 bits. If the user account directory for the account indi- 
cated already has 1 1 names assigned to it, the following 
messages will type: 



NEW 
FULL 



The operator must first cancel an old name before he can add 
a new name if the directory is full (see CANCEL NAME). 

EXAMPLES: 

*NAME © 
BIJONES © 
OLD 



60000023 



/ © 



This command can be continued for subsequent account and 
user names. Note that the parameter word can be followed 
by either a carriage return or line feed. 



*NAME 
AlABC 
00001025 
A2BCA 

00001026 



/© 



POINTER 



COMMAND: POINTER 



FUNCTION: Determine the next available overflow fil 
directory storage area. 
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After the command has been given, the program will respond 
with the message: 

OVERFLOW POINTER AT: nnnn 

where nnnn is the current location of the overflow printer, 

REMOVE LETTER 

COMMAND: REMOVE LETTER @ 

FUNCTION: Allows the operator to remove a broadcast 
letter from the letter bit map so that it is no 
longer addressed to anyone. Note that this 
makes the count (see COUNT LETTER) equal 
to zero. The actual letter text is not changed. 

REMOVE LETTER automatically resets the 
letter switch to "ON". Therefore, the Exec- 
utive will begin typing letters to any users 
which are on the system. The operator should 
not attempt to add a letter after removing 
one without first returning to the Executive 
and executing the LETTER command. 

After giving the command, the program will type: 

LETTER NO.: 

and the operator must respond with a letter number, which 
must be a number from 1 to 6, The program will then 
remove the letter from the letter bit map. 

EXAMPLE: 

*REMOVE LETTER © 
LETTER NO.: 2 @ 



RESET TIME 

COMMAND: RESET TIME @/© 

FUNCTION: Provides to an OUTPUT FILE the real and 
computer time for all users and clears the 
computer end real times from the file direc- 
tory storage area; the command may also be 
used for selected users. 

Same as for the command TIME, 

For examples of output see TIME. 

Note that this command actually clears the computer and 
real time words from the file directories after outputting 
the information. 

SET DAY 

COMMAND: SET DAY @ / © 

FUNCTION: Validates all or selected users for 24-hour 

usage of the time-sharing system. 



If command is terminated by carriage return, no other action 
is required by the operator. The routine will set the valid 
time word in every file directory to 77777777 which validates 
the users for 24-hour usage of the system. The program will 
type END OF JOB when completed. 

If command is terminated by line feed, operator must type 
the user numbers for the users to be validated for 24 hours. 
The command must be terminated by typing a user number 
greater than the last valid user number such as 7777) this 
will cause the program to type the END OF JOB message. 

EXAMPLES: 

-GO /O PER/© 

*SET DAY © 

END OF JOB 



-GO /OPER/ © 
^SET DAY © 
121 © 
23 © 
7777 @ 
END OF JOB 

SET HOUR 

COMMAND: SET HOUR © / © 

FUNCTION: Validates all or selected users for any selec- 
ted time of the day. 

If command is terminated by carriage return, the program 
will type each user number, together with computer time, 
real time, and valid on-time and will pause after typing out 
the parameters for each user to allow the operator to change 
the valid on-time. If the operator does not care to change 
the valid on-time for a particular user, he merely types a 
line feed. Otherwise, he types the valid on-time word ter- 
minated by a carriage return. The program will then type 
out the parameters for the next user. After the last user 
parameters have been typed out, the program will type END 
OF JOB. 

If command is terminated by line feed, the operator must 
type the user numbers of those users whose time parameter he 
wishes to change. The program will respond by typing the 
user number, computer time, real time and valid on-time. 
The operator may then type the new on-time parameter and 
terminate by typing a carriage return. (If a line feed is used 
to terminate the valid time word, the program wi 1 1 not change 
the valid time word.) The operator must terminate the com- 
mand with a user number greater than the last valid user 
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number, normally 7717 . The program will then write out 
the last file directory and type the message, END OF JOB. 

Note: The time parameter word consists of one bit for each 
hour of the day where the left-most bit validates a 
user from 0000 to 0059, the second bit from 0100 
to 0159 etc. To validate a user from noon to 1559, 
the operator would type the following time 
parameters: 

7400 @ 



EXAMPLES: 



-GO /OPER/ @ 
*SET HOUR @ 

1 0/03.41 1:10 77777777 © (Does not desire 

to change) 

2 0:00.00 0:00 7777777 70 © (Validates a user for 

the hours 1800 to 

3 etc. 2059 only) 

-GO /OPER/ © 

^SET HOUR © 

240 © 

240 0:01.23 3:45 70000000 © (No change) 

137 @ 

137 0:02.23 10.54 7777 \7777 @ (Changes the valid 
^^^^ ^ hours from "1200 

^^^7® to 2359" to "1100 

2359") 

END OF JOB 
SIZE ACCOUNT 

COMMAND: SIZE ACCOUNT © 

FUNCTION: Computes the maximum disc storage used by 
account from LENGTH outputs and provides 
this maximum as an input for the next SIZE 
ACCOUNT run. 

The routine requires two input files and two output files 
which are requested by the program as needed. The con- 
tents of these files are as follows and the file names must 
be typed in the order indicated: 

File 1 - INPUT FILE: 

New input. Normally the output of a LENGTH run 
for the current day. 

File 2 - INPUT FILE: 

Previous maximum. Normally the maximum output from 
a previous SIZE ACCOUNT run which was produced as 
output file 4 previously. This Input may also be the 
output of a LENGTH run if there has been no previous 
SIZE ACCOUNT run. 



File 3 - OUTPUT FILE: 

The complete report of the current run. First column 
is the same as input number 1, second column is the 
maximum between input file 1 and 2 and is the same 
as output file 4. The third column is the difference 
between Input file 1 (new input) and the input file 2 
(previous maximum) a number preceded by a minus sign 
indicates that the new SIZE is less than the previous 
maximum and that output on file 4 will not change from 
the previous maximum. If the third column is positive, 
then the new size file 1 was greater than the previous 
maximum so that the new maximum output will be equal 
to the new input. 

File 4 - OUTPUT FILE: 

New maximum. The format of this output is exactly the 
same as the format of the LENGTH output. This will 
normally be input file 2 for the next days run of SIZE 
ACCOUNT. 

The program will type END OF JOB when completed. Fig- 
ure 30 shows an example of SIZE ACCOUNT. 

TIME 

COMMAND: TIME ©/© 

FUNCTION: Provides to an OUTPUT FILE the real and 

computer time for all users or types the real 
and computer time for a selected user. 

If command is terminated by a carriage return, the program 
will ask for the output file by typing "OUTPUT FILE". The 
operator should then type any appropriate output file name. 
If a bad file name is supplied the program will type the 
message "OUTPUT FILE:" again. The message END OF 
JOB will be typed when the last user's time has been output. 

If command is terminated by a line feed, the program 
assumes the output file will be the teletype. The operator 
must type the user numbers for the time parameters to be 
typed out. When a user number is typed that Is greater 
than the last valid user number (normally 7777), the pro- 
gram will type out the total that has been typed and then 
will type END OF JOB. Figure 31 shows an example of 
TIME. 



UAD 



COMMAND: UAD © / © 

FUNCTION: Outputs to a file all or selected user account 
directories. 

If command is terminated by carriage return, the program 
will ask for the output file by typing OUTPUT FILE. The 
operator should then type any appropriate output file name. 
If a bad file name is supplied, the program will type the 
message OUTPUT FILE:. The message END OF JOB 
will be typed when the last user account directory has 
been output. 
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7/1 


0:31 






ACT 


NEW INP. 


NEW MAX. 


DIFF. 


*1 


797696 


1330176 


532480 


*2 


260352 


574720 


314368 


*3 


445696 


557056 


111360 


*4 


721408 


1173248 


451840 


*5 


856832 


1026816 


169984 


*6 


88320 


122624 


34304 


*1 


317696 


338432 


20736 


A8 


12544 


12544 


512 


Al 


217088 


217088 


4608 


A2 


52736 


52736 





A4 


182784 


183552 


768 


A5 


87040 


133376 


46336 


A6 


12800 


13312 


512 


B8 


27136 


27136 





Bl 


13824 


22784 


8960 


B2 


80384 


85760 


5376 


B3 


11008 


11008 


1024 


B5 


123904 


124928 


1024 


B6 


528640 


539904 


11264 


C8 


133888 


136704 


2816 


CI 


58880 


72960 


14080 


C2 


2560 


2560 


(a 


Jl 


2560 


2560 





J2 


12288 


13312 


1024 


J4 


6912 


8704 


1792 


Kl 


70400 


100608 


30208 


K2 


175872 


177408 


1536 


L2 


24064 


46592 


22528 


L3 


22784 


27136 


4352 


Ml 


13824 


28672 


14848 


Nl 


1536 


10752 


9216 


N2 


4352 


9728 


5376 


N3 


38656 


44800 


6144 


N4 


10240 


10240 


1792 


N5 


39936 


39936 


8960 


N6 


7936 


7936 





N7 





10496 


10496 


08 





35840 


35840 


07 





5376 


5376 


TOT: 


7373056 


9600768 


2200832 



Figure 30. Example of SIZE ACCOUNT 



If command is terminated by line feed, the program will 
ask for on output file as above. After typing the output 
file name, the operator should then type the account num- 
ber of the user/account directories that he desires with 
each account number except the last one terminated by a 
line feed. The last one will be terminated by a carriage 
return. The account numbers are typed by the opera- 
tor in the usual letter/number format. Figure 32 shows 
examples of users' output. 



-GO 


/OPER/ © 






*TIME 


® 






OUTPUT TO: TEL @ 






7/3 


14:08 






1 


0:00.71 


0:24 


77777777 


5 


0:03.40 


0:29 


77777777 


6 


0:00.20 


0:03 


77777777 


17 


0:00.15 


0:05 


77777777 


20 


0:00.26 


0:08 


77777777 


25 


0:96.53 


1:26 


77777777 


27 


0:00.00 


0:01 


77777777 


32 


0:00.41 


1:14 


77777777 


45 


0:0 @ 






-GO 


/OPER/ @ 






*TIME 


© 






7/3 


14:09 






25 @ 








25 
20 © 


0:06.53 


1:26 


77777777 


20 

5 ® 


0:00.26 


0:08 


77777777 


5 


0:03.40 


0:39 


77777777 


7777 © 






TOTAL 


0:10.20 


2:03 




END JOB 







Figure 31. Example of TIME 



USERS 

COMMAND: USERS @ 

FUNCTION: Provides the operator with a list of valid 

users on the system, sorted by user number, 
account number or user name. 

The operator types the command USERS terminated by a 
carriage return. The program will then request an out- 
put file. After the operator types the file name, the 
program will respond with: 

SORT ON WHAT COL. (1,2, or 3): 

The operator then types 1, 2, or 3 for output sorted by user 
number, account number, or user name, respectively. 

EXAMPLE: See user output on previous page. 

DISC ZERO 

COMMAND: DISC ZERO © 

<Password> 

FUNCTION: This command will zero out all the discs on 
the system. 



62 OPER Program 



-GO /OPER/ © 








*USERS 










OUTPUT TO: TEL 






7/3 


14:13 








SORT ON WHAT COL.? (1,2, OR 3) 


: 3 


12 


*2 


* 


1 


= User Number 


1166 


Gl 


0038 


2 


= Account number 


522 


Gl 


0035 


3 


= User Name 


521 


Gl 


0036 






1171 


Gl 


0500 






525 


E5 


1 






277 


D5 


1 






536 


E5 


10 






537 


E5 


11 






654 


G3 


141 






655 


G3 


142 






656 


G3 


143 






526 


E5 


2 






301 


D5 


2 






624 


G7 


200 


WRIGHT 




623 


G7 


200 


SPEIR 




622 


G7 


200 


CHIOCHIO 




621 


G7 


200 


JOHNSON 




711 


G7 


200 


PATAPOFF 




1170 


Gl 


2000 






626 


G7 


250 


BRICK 




625 


G7 


250 


SNYDER 




527 


E5 


3 






302 


D5 


3 






1167 


Gl 


3000 






657 


G3 


345 






660 


G3 


349 






530 


E5 


4 






531 


E5 


5 






630 


G7 


500 


SCHWARTZ 




627 


G7 


500 


GUGGENHE 




532 


E5 


6 






1210 


12 


658&C 






1206 


12 


671&0 






1207 


12 


674&N 






533 


E5 


7 






661 


G3 


7466 






534 


E5 


8 






662 


G3 


8466 






602 


E4 


8803 






604 


E4 


8811 






603 


E4 


8810 






357 


E4 


8812 






535 


E5 


9 






1172 


Gl 


9000 






663 


G3 


9466 






1232 


N8 


(ctLMY&SK&C 




6 


*2 


A 






433 


F3 


A BROWN 




171 


Bl 


A. COX 






1203 


G4 


A. BELL 





Figure 32. Examples of User Output 



The operator types the command DISC ZERO, then a line 
feed. After the line feed which terminates the command, 
there will be no output on the teletype. However, the 
program is waiting for the password to be typed. Suppose 
the password is the word SDS and the control key must be 
depressed while all of the letters are typed. The following 
example applies: 

*DISC ZERO © 

Control SDS 



If NDISC (a system parameter) were equal to 8, then all 8 
discs would be zeroed. 



DISC EDIT PROGRAM 

The purpose of the disc edit is to arrange the files on the 
disc for optimum data access. This routine places the files 
that are least often accessed farthest from the center arm 
positions (outside the mapped area). The files most often 
accessed are placed nearest the center, thus leaving all 
available free space at the access center. 

The I/O control section of the Monitor always writes files 
within the mapped area of the disc. If the user opens for 
output (rewrites) an old file that has been moved to the 
outer arm positions by EDIT, the Monitor will rewrite the 
file within the mapped area. 

PHASE ONE 

In Phase One, each file directory (FD) is read, the edit bit 
set (bit 2 of word 1 of the file entry), the file length com- 
puted and stored in the file entry, and the FDs rewritten. 
The index blocks, for files which have been updated since 
the last time this program was run, are read, the user num- 
ber stored in the last word, and the block written back. 

An entry for every file on the disc is created in one of two 
tables that are built as the FDs are read. On table con- 
tains a two word entry for each file whilch has been read or 
written since the last time this program was run. (This is 
called the AB table.) The two words contain the last 
access data, access count, index block, disc address, and 
the number of data blocks in the file ( includes the index 
block). The other table contains an entry for each file 
which has not been accessed since the Itfst time the pro- 
gram was run. Each entry is one word containing the 
index block blocks of the file, (This Is called the 
C table.) 

PHASE TWO 

The two tables (AB, C) are sorted. The AB table Is sorted 
by access count and access date. The C table Is sorted by 
index block disc address. 
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PHASE THREE 



OPERATING INSTRUCTIONS 



The files in the AB table are read from the disc, new index 
blocks created, and the files written on tape, A three- 
word record for each file is created and written on the RAD. 
The record contains the user number, the old index block 
disc address and the new index block disc address. 

PHASE FOUR 

Reads files in the C table and either writes them at their 
new location on the disc or writes them on tape until suffi- 
cient space is available to start writing them on the disc. 
This situation would occur if the total space required for 
the files was reduced since the lost time this program was 
run and the free space exceeded 25 percent of the total 
capacity. A three-word record is created for each file 
and is written on the RAD. It contains the same informa- 
tion as the records written for the AB type files. 

PHASE FIVE 

The AB type files are read from tape and written in their 
assigned locations on the disc. 

PHASE SIX 

The C type files (if there are any on tape) are read from 
tape and written in their assigned locations on the disc. 

PHASE SEVEN 

The FDs are updated using the records written on the RAD. 
All records on the RAD are, so to speak, "passed" twice 
against each block of 64 FDs. When o RAD record is found 
to match a file entry for a particular user, it is marked and 
written back to the RAD and the index block disc address 
and access count is updated and the edit bit reset in the 
file entry of the FD. On the second "pass", before the 
block of FDs are written back to the disc, the edit bit is 
checked in each file entry and if found still set, a message 
is output to the typewriter with the user number and file 
name of the entry. Any file lost because its index block or 
data blocks were in error or couldn't be read or written, 
would appear in this list. All the RAD records are read and 
checked for mark bit set. If the mark bit is not set the user 
number and the old and new index block disc addresses are 
output to the typewriter. These should match with previous 
typeouts from the edit bit check of the FDs. 

PHASE EIGHT 

The operator is allowed to correctly enter new index block 
disc addresses for files which the program could not correctly 
identify. 

PHASE NINE 

^^11 tiie inuex biocKS ore read and tne lost word checked 
against the user number to see that all files are properly placed. 
A message is output for files which do not check and should 
match with messages from phase seven. This is a check only 
and is not really necessary. It can be aborted at any time. 



The operator .nay wish to take a disc dump to preserve the 
old status of the disc before running the edit. 

1. With the system in time sharing mode, the operator 
should log in and type: 

-PLACE /Name of disc edit/ 

-SYS DP @ 

TO 1 €'J^ 

LOG 1 %) 

This will put the edit program onto disc 1. 

2. Take the system down by setting breakpoint 4. After 

a few seconds, lower the run switch to "idle" and press 
"start". 



3. Mount the utilities tape which contains the DSWAP 
program. Also, mount a scratch tape on unit 6, set at 
800 bpi. The edit routine uses this tape. After DSWAP 
has been read in, mount a second scratch tape on unit 
7, set at 800 bpi. 

4. Insure that the console teletype is turned on. The edit 
routine converses through this teletype. 

5. Set breakpoints 1 and 4 and load the DSWAP program. 
DSWAP will bring in the edit program from disc 1. 



COMMANDS TO THE EDIT PROGRAM 

EDIT will begin to type the following commands. New unit 
and old unit will be the same except when it is desired to 
increase or decrease the number of discs being used by the 
system. The port of the command typed by the operator is 
under I in ed. 

FILE REORDER ROUTINE. READY MT 6, 7 

TYPE DATA AS FOLLOWS: MM-DD-YR 12-06-68 

TYPE LAST USER NUMBER-: 2377 

TYPE NUMBER OF DISCS IN NEW UNIT AS :DD: 
(Type :08^, : 1_6^ or :32^) 

TYPE NUMBER OF DISCS IN OLD UNIT AS :DD: 
(Type :_08^, :]6^ or :32^) 

SET USER NUMBER IN I. B. -: (Type YES ^or 

NO @ @ ) 

Used for initial edit or when user number has been 
lost from the index block. 

BEGINNING -00146440 ENDING 00177374 
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At this point the system will type any error messages. The 
error messages will be discussed later. 

JOB FINISHED 

ANY FILES TO CORRECT: (The operator responds 
YES or NO depending on whether or not there 
were error messages. ) 

CHECK STARTED 
END CHECK 

ERROR MESSAGES 

The following procedure can be used to recover files which 
the EDIT program could not identify. EDIT will first list 
the files for which it has a name but has lost the new index 
block pointer. Next it will list the files for which it has 
a new index block pointer but has lost the user number and 
file name. The operator can match up the two entries (if 
possible) when the line "ANY FILES TO CORRECT" is 
typed. 

The format of the error messages is: 

I.B. L: iiiiiiii USER uuuuuuuu FILE NAME ffffff 

I.B. OLD iiiiiiii USER nnnnnnnn IB NEW iiiiiiii 
LOST FILE 

If the operator responds "YES" to the "ANY FILES TO 
CORRECT" message, the following will be typed. 

USER NUMBER: (Type the 4 digit user number) 

OLD INDEX BLOCK ADDRESS: (Type the 8 digit 
index block address) 

NEW INDEX BLOCK ADDRESS: (Type the 8 digit 
index block address) 

OK: (Type YES @ if the information input is correct) 
(Type NO @ © to start over) 

IB OK: iiiiiiii USER uuuuuuuu FILENAME ffffff 

OK: (Type YES ©if this is the correct file and 

NO© © if not correct file. It will allow you 
to try again. ) 

ANY FILES TO CORRECT: (Type YES ©if more 
files to correct, otherwise type NO© © ) 

CHECK STARTED (This procedure may be aborted any 
time. ) 

END CHECK 

MESSAGES REQUIRING OPERATOR ACTION 

FATAL ERROR, CAN'T R/W FDs AT ( Disc Address ) 
Action: This message indicates a bad disc spot. 



TAPE NOT READY - TOGGLE RUN SWITCH WHEN READY 

Action: Put tape in ready and follow the instruction in the 
message. 

SET 800 BPI TOGGLE RUN SWITCH WHEN READY 

Action: Follow the instruction. 

PUT RING IN TOGGLE RUN SWITCH WHEN READY 

Action: Follow the instruction. 

BAD TAPE TOGGLE RUN SWITCH WHEN READY 

Action: Mount different tape. 

BAD TAPE RESTART THE JOB 

Action: Restart the program from disc, will not be necessary 
to restore the disc since nothing has been written yet. 

FATAL ERROR WHILE WRITING ON TAPE--OK TO RESTART 

Action: Restart the program from disc, will not be necessary 
to restore the disc since nothing has been written. 

RAD ERROR HAS DESTROYED DISC DATA 

RECOVER DISC FROM PREVIOUS DUMP AND RESTART 

Action: Total restart. 

DISC ERROR HAS DESTROYED DISC DATA 

RECOVER DISC FROM PREVIOUS DUMP AND RESTART 

Action: Total restart. 

TAPE ERROR HAS DESTROYED DISC DATA 

RECOVER DISC FROM PREVIOUS DUMP AND RESTART 

Action: Total restart. 

IF CORRECT TAPE TOGGLE RUN TO TRY AGAIN 

Action: Caused by a tape label error. If the correct tape 
is mounted, follow instructions. 

TAPE READ ERROR- 
RECORD NUMBER IS-: nnnnnnnn S/B nnnnnnnn TOGGLE 
RUN TO START AGAIN 

Action: Follow instructions. If It does not correct, the 
record can be accepted as Is by setting switch 4 before tog- 
gling run, then resetting switch 4. 

DISC WRITE PROTECT 

Action: Set disc write protect switches off and toggle run 
swi tch. 

IB RD: iiiiiiii USER uuuuuuuu FILE NAME ffffff 

Action: Look In the listing of files under the user given the 
message for a matching index block disc address and file 
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name. Recover this file from a previous disc dump. Files 
indicated by this message cannot be recovered during file 
recovery procedure. 

DISC ERROR AT (disc address) 

FILE BAD IB: iiiiiiii 

Action: The index block address v^ill match with q and r 
messages. This file can be recovered during the file recov- 
ery procedure but will have errors in it. 

IB L: iiiiiiii USER uuuuuuuu FILE NAME ffffff 

Action: Match with r messages for recovery. 

IB OLD iiiiiiii USER uuuuuuuu IB NEW Iiiiiiii LOST FILE 

MESSAGES REQUIRING NO OPERATOR ACTION 

JOB FINISHED 

CHECK STARTED 

END CHECK 

TAPE ERRORS—: nnnnnnnn 

BEGINNING - nnnnnnnn ENDING - nnnnnnnn 

EXAMPLE OF AN EDIT RUN 

FILE REORDER ROUTINE. READY MT 6:7 

TYPE DATA AS FOLLOWS: MM-DD-YR 07-05-67 
TYPE NUMBER OF DISCS IN OLD UNIT AS :DD: :_16: 
TYPE NUMBER OF DISCS IN NEW UNIT AS :DD: :_16: 
SET USER NUMBER IN I. B.-: NO ® © 
BEGINNING - 00327454 ENDING - 00377374 

DISC ERROR AT 00025362 
DISC ERROR AT 00025365 
FILE BAD IB: 00025361 

IB L: 00075304 USER 00000027 FILE NAME /ER/ 

IB L: 00025361 USER 00000107 FILE NAME /EVEN/ 

IB L: 00025044 USER 00000414 FILE NAME /MOON/ 

IB L: 00005615 USER 00000650 FILE NAME /RAB/ 

IB L: 00002231 USER 00000667 FILE NAME /PAYROLL/ 

IB OLD 00075304 USER 03300200 IB NEW 00026457 
LOST FILE 

IB OLD 00025361 USER 40000107 IB NEW 00062155 
LOST FILE 

IB OLD 00025044 USER 03027447 IB NEW 00051333 
LOST FILE 



IB OLD 00055615 USER 01627460 IB NEW 0006571333 
LOST FILE 

IB OLD 00002231 USER 0000000 IB NEW 00045140 
LOST FILE 

JOB FINISHED 

ANY FILES TO CORRECT: YES @ 

USER NUMBER: 0027 
OLD INDEX BLOCK ADDRESS: 00075304 
NEW INDEX BLOCK ADDRESS: 00025457 
OK: YES @ 

IB OK: 00075304 USER 00000027 FILE NAME /ER/ 

OK: YES ® 

ANY FILES TO CORRECT: YES ® 

(Repeat the above procedure for users 107, 414, 650and667) 

ANY FILES TO CORRECT: NO @ ® 

CHECK STARTED 

IB CH:00026457 USER 00000027 FILE NAME /ER/ 

IB CH:00062155 USER 00000107 FILENAME /EVEN/ 

IB CH:00051333 USER 00000414 FILE NAME /MOON/ 

IB CH:00065713 USER 00000650 FILE NAME /RAB/ 

IB CH:00045140 USER 00000667 FILE NAME /PAYROLL/ 

END CHECK 

MAP PROGRAM 

The Monitor assigns disc space for files by utilizing a disc 
bit map. Each bit in the map represents a 256 word block. 
If the bit is set, the block is available. The bit map Is in 
the Monitor. The purpose of this program Is to initialize the 
bit map, release the disc space occupied by bad files (files 
with invalid index block pointers, conflicting information, 
etc), and indicate in the user's file directory that the file 
has been deleted. 

Note that MAP does not attempt to either re-allocate or 
optimize the disc files. This function is performed by the 
EDIT program, MAP simply reads each file directory in the 
system and initializes the bit map to reflect the current sta- 
tus of the disc. 

The MAP program is run if a new version of the Monitor has 
been brought into core using the DSWAP program. When the 
Monitor is assembled the bit map contains all ones. The 
map must be changed to reflect the current disc environment. 
The MAP program is also run after the edit program has 
changed the positions of the files. 

The disc map does not reflect all of the area of the disc. 
On an 8 or 16 disc system the bit map only represents arm 
positions 12 through 51. On a 24 or 32 disc system, arm 
positions 22 through 41 are mapped. 
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It is not advisable to restart the MAP program if any errors 
occur while it is running. The program will have partially 
initialized the bit map at this point. To start the program 
again would cause conflicts in the map. One should reload 
the Monitor system and then restart MAP. 

In order to reduce disc arm movement the index block 
pointers are first collected from the file directories and 
sorted according to disc location. In the process of going 
through the file directories, a message is typed if the end- 
of-file directory flag is missing or if the Index block 
pointer (BP) is invalid. The sorting Is accomplished by 
first extracting off the high order six bitsofthedisc address 
of the IBP and packing the remaining bits with the user 
number into a single word (the user number occupies the 
low-order 12 bits). The user number would be used in case 
of an error to remove the file from the file directory. The 
high-order six bits are used as an index Into 64 pockets, 
two pockets for each disc. The packed IBP and user num- 
ber is sorted into the appropriate pocket by using strings of 
128 word packets as necessary. Since the storage area 
consists of six pages, a total of 96 packets are available, 
allowing the storage of well over 10,000 Index block 
pointers. 

After the sort, the index block pointers are delivered to 
the Monitor using the BRS BE+5. If there Is an error return, 
the program stores the IBP and the user number in an error 
list and sets on error flag. Also the program will type the 
IBP, the word returned by the Monitor in the A register 
(which is usually the disc address of the error), and the 
user number and then wait until a carriage return Is typed 
by the operator before continuing. 

After executing the BRS BE+5 for all IBPs, the error flag Is 
checked. If there has been an error, the program types a 
message that the file deletion is about to start and waits 
for a carriage return to be typed before continuing. After 
receiving the carriage return, the program goes through the 
list of errors and releases the disc space occupied by the 
bad files. The MAP program does not delete the bad file 
entry from the customers file directory (FD). However, 
the file type (see bits through 5 of word 2 of a FD entry) 
Is set to 40B, Since 40B Is not a legitimate file type, the 
file will be removed from the FD the next time the user's 
file directory is written ( by LOGOUT, WRITE FD, etc.). 

If there are no errors or when the last bod entry has been 
deleted, the program searches the accounting storage area 
for the next available sector. Indicated by the first word 
of the sector being zero. The sector number of the account- 
ing area Is typed for the operator. The program then searches 
the file directory overflow area and determines the location 
of the next available overflow area and types it out. If 
there are less than 40 overflow areas left, a special mes- 
sage Is typed giving the actual number of areas left. 
The disc address of the next available accounting area 
and the address of the next overflow area are delivered 
to the Monitor using the BRS BE+5 along with a termi- 
nation flag. This completes the operation of the MAP 
program. 



OPERATING INSTRUCTIONS 

The program is a "GO TO" type program and the operator 
starts the program by typing: 

-GO /MAP/ © 

The program responds by typing the following message and 
begins going through the file directories: 

SYS. V MAP STARTED. 

V is the MAP program version number. 

No further action is required by the operator unless there 
is on error message. The program will type the following 
messages upon completion of building the map; 

ACCOUNTING AT: aoo 

OVERFLOW POINTER AT: bbb 

END JOB 

where "oaa" is on octal number corresponding to the account- 
ing area sector (64 words) area. If "oaa" is there Is no 
accounting information stored. If it is 177 there is no 
remaining accounting storage area and the area must be 
cleared by using the CLEAR RECORDS command In the 
/OPER/ program. Note that the system must be taken down 
after clearing the accounting area so that the /MAP/ pro- 
gram can be rerun. The number "bbb" is the next available 
overflow area and normally varies from 1377 to 1 1 00 on on 
eight-disc system and from 2377 to 2000 on a 16- or 32- 
dlsc system. Note that the first number (1377 and 2377) 
shows that no overflow directories are being used while the 
second number would show that no more overflow directories 
are available. The /OPER/ command GARBAGE must be 
executed before these second numbers ore reached. 

ERROR MESSAGES AND ACTION 

FILE DIRECTORY END FLAG MISSING FOR USER: nnn 
where "nnn" is the user number. The operator may: 

1. Type a carriage return in which case the program will 
continue and the bod file directory will remain on the 
disc. 

2. Stop the MAP program and use DDT to supply a valid 
end pointer to the file directory. The system must then 
be reloaded and MAP restarted. 

CONFLICT AT ppppp qqqqqq nnn © 

where "ppppp" Is the Index block pointer and "qqqqqq" Is 
the disc address of the data block that caused the conflict, 
and "nnn" Is the user number (or overflow pointer) of the 
file directory that contains the conflict. A conflict implies 
that two or more files reference the some disc area, MAP 
will always map the first file and regard the second file as 
the conflict. The conflict Is easily recognized because the 
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BRS BE+5 will attempt to reset a bit that is already reset. 
The operator may: 

1. Type a carriage return in which case the program will 
continue after storing the IBP and user number In an 
error list, 

2. Take the system down and reload the disc. 

BAD INDEX BLK. PTR. : ppppp nnn © 

where "ppppp" is the bad index block pointer and "nnn" is 
the user number. This message indicates that the number 
"ppppp" is an illegal disc address, A disc address must be 
greater than and less than or equal to LIBP : 

LIBP: = 37777B 8 Disc 

= TJim 16 Disc 

= 137777B 24 Disc 

= Mlin^ 32 Disc 

The operator may: 

1, Type a carriage return in which case the program will 
continue and the bad pointer will remain in the file 
directory. 



2, Stop the MAP program and use DDT to remove the file 
directory entry from the disc. If the file type is changed 
to 40B, the file will be deleted from the user's directory 
the next time his directory is written, 

BAD FILE DELETION STARTING, 

This message will only type if the error message "CONFLICT 
AT" has previously been typed by the program. At this point 
the bit map has been built and the program is ready to delete 
the bad files. The operator may: 

1. Type a carriage return in which case the bad files will 
be deleted. 

2, Take the system down and either reload the disc or start 
up ogain in the case of disc errors, 

ONLY nn OVERFLOW F,D, AREAS LEFT 

where nn is the actual number of overflow file directory 
areas left. This message is only typed if there is less than 
40 areas left. The operator may: 

1. Run the "GARBAGE" routine in the "OPER" program 
(see "OPER" instructions). 

2. Ignore the message, hoping that the remaining areas 
will be sufficient until the GARBAGE routine can be 
run at a later time. 
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A resident part of the system is o packoge of string handling 
outlines. These are discussed in detail in the second half 
of this manual. They are: 

GCI Get character and increment 

WCI Write character onto string 

WCH Write character onto string storage 

SKSE Skip on string equal 

SKSG Skip on string greater 

GCD Get character and decrement 

WCD Write character and decrement 

BRS 5 Look up string in hash table 

BRS 6 Insert string in hash table (must be preceded 
by BRS 5) 

BRS 33 Input string 

BRS 34 Output string given word address 



BRS 35 Output string given string pointer 

BRS 37 General command lookup 

SPS includes symbol table lookup facilities, and a string 
storage data collector, available as a library routine. 
Strings are composed of 8-bit characters packed 3 per word 
and are addressed by 2-word string pointers. Two SYSPOPs 
formally part of SPS but useful in floating point operations 
and in general programming are: 



LDP 
STP 



Load pointer 
Store pointer 



These are doubleword operations which load A and B from 
the effective address and the next location, or store A and 
B into the effective address and the next location. 

String pointers are discussed under ''Executive Treatment of 
Files". The general concept of manipulating characters 
that are packed three per word is discussed under "Echo 
Tables". String handling routines are discussed in detail 
under "String Processing". 



68 String Processing System (SPS) 



19. FLOATING POINT 



Floating point arithmetic and input-output operations have 
been incorporated into the 940 system through the use of 
programmed operators. This allows the user to perform 
arithmetic and I/O operations in a single instruction, A 
brief summary of the most commonly used arithmetic and 
I/O POPs is given in this chapter. 

The floating point numbers referenced in this chapter are 
normalized double word values. The first word Is a sign 
bit followed by the 23 high-order bits of the mantissa; the 

Floating Point Load/Store Instructions 
Example 1 



second word consists of the 15 low-order bits of the mantissa 
followed by a 9-bit exponent field that, like the mantissa, 
is represented In two's complement form. 

Unless otherwise specified, the POPs do not make a skip 
return. 

The remaining floating point SYSPOPs and BRSs use o format 
word in register X that contains the Information shown in 
Figure 33. 



NAME: LDP 

FUNCTION: Load pointer 

CALLING SEQUENCE: LDP Memory 

DESCRIPTION: Loads A, B with MEMORY, MEMORY+1. 

LDP Is a single instruction that Is equivalent to 

LDA MEMORY 

LDB MEMORY+1 



NAME: STP 

FUNCTION: Store pointer 

CALLING SEQUENCE: STP 



MEMORY 



DESCRIPTION: Replaces MEMORY, MEMORY+1 with the contents of A, 
that is equivalent to 



B. STP MEMORY is a single instruction 



STA 



MEMORY, STB 



MEMORY+1 



Double Word F loating Point Arithmetic 
Example 2 



NAME: FAD 


FUNCTION: Floating add 


CALLING SEQUENCE: FAD MEMORY 


DESCRIPTION: The floating point value at MEMORY, MEMORY+1 Is added to the floating point value in A, B. 


The sum replaces the value in A, B. Memory Is unaffected. 


NAME: FSB 


FUNCTION: Floating subtract 


CALLING SEQUENCE: FSB MEMORY 


DESCRIPTION: The floating point value at MEMORY, MEMORY+! is subtracted from the floating point value in 


A, B. The difference replaces the value in A, B. Memory is unaffected. 


NAME: FNA 


FUNCTION: Floating negate 


CALLING SEQUENCE: BRS 21 


DESCRIPTION: The floating point value in A, B is negated. The result is left in A, B. 
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NAME: FMP 

FUNCTION: Floating multiply 

CALLING SEQUENCE: FMP MEMORY 

DESCRIPTION: The floating point value at MEMORY, MEMORY+1 is multiplied by the floating point value in 
A, B. The product replaces the value in A, B. Memory is unaffected. 



NAME: FDV 

FUNCTION: Floating divide 

CALLING SEQUENCE: FDV MEMORY 

DESCRIPTION: The floating point value in A, B is divided by the floating point value at MEMORY, MEMORY+1. 

The quotient replaces the divident in A, B. Memory is unaffected. Division by zero causesan overflow. 



NAME: FIX 

FUNCTION: Conversion from floating point to fixed point 

CALLING SEQUENCE: BRS 50 

DESCRIPTION: The floating point value in A, B is converted to fixed point. A is replaced by the integer part of 
the original value, the fractional part is left adjusted in B. If the integer is too large, the most 
significant bits are lost. 



NAME: FLOAT 

FUNCTION: Conversion from fixed point to floating point 

CALLING SEQUENCE: BRS 51 

DESCRIPTION: The integer in A is floated. The floating point result is left in A, B. 



Bits 


Field 
Name 


Significance 


0-2 


T 


Format types: 

Octal 

1 Integer 

2 E format with the number right justified in the specified field on output. 

3 F format with the number right justified in the specified field on output. 

4 J format with the number left justified in the specified field on output. 

5 F format with the number left justified in the specified field on output. 

6 Double precision format. Same as 2 on input. On output same as 2 except a 
D will be output for the exponent if bit 16 is 1. 

7 Free form (output left justified). 


3-8 


D 


Number of digits following the decimal point. 


9-14 


W 


Total field width. In J format that is the number of digits before the decimal point. 


15 





Overflow action. If the field width is too small on output and this bit is 1, the first 
character of the output field will be a star and characters to the right will be lost. 
If this bit is zero and overflow occurs, characters on the right will be lost. 


16 


E 


If this bit is 1, E format of output will be used to represent the exponent. If this bit 
is the • symbol will be output. Either the E or ' is always acceptable on input. 



Figure 33. Format Word for Floating Point 
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Bits 


Field 
Name 


Significance 


18 




If this bit is on input" the symbol ^ will be treated as a legal exponent identifier; 
i.e., 1.0^+2 will be legal input. If this bit is 1 the symbol ^«J will be treated as 
an illegal character. This bit has no effect on output. 


19 




If this bit is 0, illegal characters in the input string will be Ignored. The error flag 
will be set when one is read. If this bit is 1 and an illegal character is read, the 
scan will be terminated, the error flag will be set and the string pointer will be set 
to the character read. The conversion will take place on the characters read to 
that point. This bit has no effect on output. 


20 




If this bit is 0, the input string ±N±M is legal. N is treated as the mantissa and M 
the exponent of a floating, real number. If this bit is 1, the second occurrence of 
a sign will be treated as an illegal character. This bit has no effect on output. 


21 




Must be zero. 


22 




Must be zero. 


23 




If a 1, the double precision accumulator will be used for numeric input-output. 
Significance is extended to 18+ digits. Applies to all format types. 



Figure 33. Format Word for Floating Point (cont. 



OPERATING CHARACTERISTICS 

On input the D file is overridden by the presence of a 
decimal point. If a decimal point and/or E are present, 
any form of the number Is acceptable to any Input format. 
It Is only in the absence of these characters that the format 
specifications determine the interpretation of the field. 
Illegal characters appearing anywhere In the field may be 
ignored depending on bit 19 of the format word. Blanks 
will be converted to zero. 

The maximum allowable number of Input digits Is twelve. 
If more than twelve digits are input the most significant 
twelve will be used. If twelve digits are used, care must 
be taken as overflow can occur during the conversion pro- 
cess. Insignificant leading or trailing zeros wi 1 1 be Ignored. 

38 
The maximum allowable Integer on Input is ±2 -1 or 

±274,877,906,913. Floating point numbers must lie In 

the range: 

9. 9999999999E -78 < number < 5. 7896044625 E +76 

Free form output will be output using an F17If the exponent 
lies In the range -1 < exponent 2 10 (X = 10 -number of 
digits to left of decimal point). If the number is outside 
this range on El 7. 1 1 will be used. Free form output always 
assumes a floating point number. If on Integer is Input It 
will be normalized prior to conversion. 

For the E format on output, the E ( f^ If bit 16 of the format 
word Is 0) is always followed by a + sign or - sign. On all 
output the sign of the number is printed only if it Is negative. 



Error Conditions: 

If an error Is detected during the conversion process a posi- 
tive Integer indicating the error type will be returned In the 
Index register as given In Table 7. 

Table 7. Error Conditions 



Error 
No. 



Error Type 



X- No error was detected. 

X- 1 Number of decimal digits after the decimal point 

exceeds 1 2 for single precision and 18 for extended 
precision on formatted Input. Twelve and 18 
used respectively. 

X=2 Field too short for E format on output. Overflow 
action will be taken depending on the value of 
bit 15 of the format word. 

X=3 Input number exceeds the maximum allowable 
bounds. 

X=4 Field too short for F or I format on output. 

Overflow action will be taken depending on 
the value of bit 15 of the format word. 

X^5 An E format was specified for Input but the Input 
string does not contain an "E" or ".". The number 
will be converted using an equivalent F format. 

X-6 An Illegal character was encountered In the 
input scan. v_iiaructer is igriored. 



Operating Characteristics 71 



String Conversion 
Example 3 



NAME: SIC 

FUNCTION: String to internal conversion 



CALLING SEQUENCE: 



LDX 
SIC 
BRU 
BRU 



FORMAT 
POINTER 
INTEGER 
FLOATING 



DESCRIPTION: FORMAT describes the type of conversion to be done (see the SDS 940 FORTRAN IV Manual, 

Pub. No. 90 11 15, for the FORMAT word specifications). The string of input characters starts 
at the character following the character pointed to by the character address in POINTER. The 
character address in POINTER+1 points to the last character of the input string. 



NAME: ISC 

FUNCTION: Internal to String Conversion 

CALLING SEQUENCE: LDP VALUE 



LDX 
ISC 



FORMAT 
POINTER 



DESCRIPTION; 



FORMAT describes the type of conversion to be done (see the SDS 940 FORTRAN IV Manual, 
Pub. No. 90 11 16 for the FORMAT word specifications). POINTER + 1 contains the character 
address of the character Immediately preceding the position where the first character of output 
is to go. POINTER+1 is incremented by one for each character of output added to the character 
string. VALUE is the double word floating point value to be converted. 



NAME: FFI 

FUNCTION: Formatted input 

CALLING SEQUENCE: LDX 



BRS 



FORMAT 
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DESCRIPTION; 



Characters are read for a file and converted to internal form. Either a floating point value Is 
left In A, B or an integer is left in A. A skip return Is generated If a floating point value Is read 
and the Input mode Is free format. 



NAME: FFO 

FUNCTION: Formatted output 

CALLING SEQUENCE: LDP VALUE 

LDX FORMAT 

BRS 53 

DESCRIPTION: The floating point value In A, B or the integer in A Is output to the file specified In FORMAT, 
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20. SCHEDULING, FORKS AND PROGRAM INTERACTION 



NUMBER: 78 

NAME: SAIR 

FUNCTION: Arm/Disarm Software Interrupts 

STATUS: User 



CALLING SEQUENCE: LDA 
BRS 



M 
78 



M is tfie complete new interrupt mask. 

DESCRIPTION: The new interrupt mask is substituted for the old one. A user may arm inter- 
rupt 1-10. An exec fork may arm interrupt 1 1 also. Interrupt 1 is in bit 4 of the mask word. 
The interrupts ore as follows: 

1 Interrupt if Program Panic (BRS 10 or Escape) 

2 Interrupt if Memory Panic 

3 Interrupt if Lower Fork terminates 

4 Interrupt If any I/O condition occurs which sets a flag bit (0, 7 or 8 in file number 
word) 

5 through 10 interrupts on condition set by user 
1 1 Interrupt if DSU error 

Location 200B plus the interrupt number must be set to point to a routine to process the 
interrupt. When the interrupt occurs.on SBRM* is executed to the location pointed to. If it 
is desired to return to the point in the program interrupted, the user must BRR to the location 
where the return was saved. 

Example: 

Set interrupt and arm it 



LDA 


=ESCAPE 


STA 


201 B 


LDA 


2B6 


BRS 


78 



REGISTERS AFFECTED: None 
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NUMBER: 79 

NAME: SIIR 

FUNCTION: Cause Interrupt 

STATUS: User 

CALLING SEQUENCE: LDA N 
BRS 79 

N Interrupt number. N has the range of 5 to 10. 

DESCRIPTION: Parallel forks in the structure are searched first and then higher forks. The 
interrupt will be caused in the first fork found which has the interrupt armed. If no fork has 
the interrupt armed, it is treated like a NOP. This would normally be used to cause inter- 
rupts 5 through 10 to interrupt. 

REGISTERS AFFECTED: None 



NUMBER: 49 

NAME: SRIR 

FUNCTION: Read Interrupts Armed 

STATUS: User 

CALLING SEQUENCE: BRS 49 

DESCRIPTION: Reads the interrupt mask into the A register. Bit 4 corresponds to interrupt 
number 1, 5 to number 2 and etc. There are 11 programmable interrupts. See BRS 78. 

REGISTER AFFECTED: A 
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NUMBER: BE+12 

NAME: TIMINT 

FUNCTION: Interrupts a Fork After a Specified Period of Time. 

STATUS: Uiier 

CALLING SEQUENCE: 



LDA 


M 


LDB 


T 


LDX 


N 


BRS 


BE + 12 


NORMAL 


RETURN 



M New interrupt mask. 

T Time in milliseconds after which the fork will be interrupted. 

N Interrupt number. 

DESCRIPTIC>N: The fork issuing this BRS will be interrupted after the delay if the interrupt 
specified by N is armed at that time. (Exception: The interrupt will be ignored if the fork 
is dismissed on a BRS 9 at the time of the interrupt. ) If a fork gives this BRS again with the 
same N before the time has passed, the new time will be set. A fork may have a maximum of 
three timing interrupts pending simultaneously. See BRS 81. 

REGISTERS AFFECTED: None 



NUMBER: 90 

NAME: DFR 

FUNCTION: Declare a Fork for "Escape" 

STATUS: User 

CALLING SEQUENCE: BRS 90 

DESCRIPTION: The PACT pointer of the fork that executes this BRS will be placed into 
location TTYASG (see Teletype Tables). If the user types "escape", this fork and all lower 
forks will be terminated. The foik above TTYASG will be activated. However, the Exec- 
utive fork will never be terminated, even if TTYASG has been assigned to it. 

REGISTERS AFFECTED: None 
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NUMBER: 46 

NAME: NROUT 

FUNCTION: Turn Escape Off 

STATUS: System 

CALLING SEQUENCE: BRS 46 

DESCRIPTION: This BRS causes the NT bit (see PIM word of PAC table) to be set. If an 
escape occurs after this BRS has been executed, it will not be honored. However, the TP 
bit will be set (see PIM). If the TP bit Is set when the user executes the BRS 47, the escape 
will then be honored. This scheme allows the first escape that occurs to be processed later 
and ignores any subsequent escapes. 

A program running with escape turned off cannot be terminated by a higher fork. 

See also, BRS 26 and 47. 

REGISTERS AFFECTED: None 



NUMBER: 47 
NAME: SROUT 
FUNCTION: Turn Escape On 
STATUS: System 
CALLING SEQUENCE: BRS 



47 



DESCRIPTION: This BRS reverses BRS 46; that is, reactivates the escape interrupt. If an 
escape occurred while in an Off condition, the escape will now be processed. 

REGISTERS AFFECTED: None 
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NUMBER: 26 

NAMt:: SKROUT 

FUNCTION: Skip if Escape Waiting 

STATUS: System 

CALLING SEQUENCE: BRS 26 

EXCEPTION RETURN 
NORMAL RETURN 

DESCRIPTION; Checks for a stacked escape for this program and if there is one, transfers 
control to the "normal leturn" or, if not, to the "exception return". Significant only after 
BRS 46. 

REGISTERS AFFECTED: None 
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NUMBER: 9 

NAME: FKST 

FUNCTION: Open Fork 

STATUS: User 

CALLING SEQUENCE: LDA 
BRS 



T Address of a "Panic Table". (See format of Panic Table in Chapter 3). 
Bits through 5 of register A have the following significance: 

Make fork system if current fork is system. 

1 Set fork relabeling from panic table. Otherwise use current relabeling. 

2 Propagate escape assignment to fork (see BRS 90). 

3 Make fork fixed memory. It is not allowed any more memory than it started 
with. 

4 Make fork local memory. New memory will be assigned to it independent of 
the controlling fork. (See section on "Memory Acquisition"). 

5 Make fork subsystem status if current fork is subsystem. 

DESCRIPTION: BRS 9 is used to create a lower fork. The panic table indicated by 
register A must not be the same for two forks of the same fork or overlap a page boun- 
dary; if it is, BRS 9 is illegal. BRS 9 creates a new fork as a fork of the fork 
creating it, which is called the controlling fork. The fork is lower in hierarchy of forks than 
the controlling fork. The controlling fork may itself be a fork of some still higher fork. 

When BRS 9 is executed by a user fork, the user fork is dismissed until the lower fork termin- 
ates. This has the same effect as issuing a BRS 31 immediately after a BRS 9. A user may 
not have more than eight forks in his fork structure. This Includes the system fork and one fork 
for each system BRS that is active. Only one system BRS can be active. 

REGISTERS AFFECTED: None. 
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NUMBER: 57 


NUMBER: 107 




NAME: CQO 


NAME: FKRA 




FUNCTION: Guarantee 16 msec Computing 


FUNCTION: Read All Fork Statuses 




STATUS: User 


STATUS: User 




CALLING SEQUENCE: BRS 57 


CALLING SEQUENCE: BRS 107 




DESCRIPTION: This BRS guarantees to the user upon return at least 16 msec, of uninterrupted 


DESCRIPTION: The status of all lower forks is recorded in the appropriate panic tables. 




computation. This is done by dismissing the user if less than 16 msec. reiTiain in his time 


REGISTERS AFFECTED: None 




quantum. 






This time will include some system overhead. Thus, if the time required is very close to 






16 msec. , a BRS 45 should be used. BRS 45 guarantees several times this amount. 






REGISTERS AFFECTED: None 






NUMBER: 30 


NUMBER: 45 




NAME: FKRD 


NAME: SQO 




FUNCTION: Read Fork 


FUNCTION: Dismiss on Quantum Overflow 




STATUS: User 


STATUS: User 




CALLING SEQUENCE: LDA P 


CALLING SEQUENCE: BRS 45 




BRS 30 


DESCRIPTION: This BRS causes the user to be dismissed as though he had overflowed his long 




P Panic Table Address 

DESCRIPTION: Reads the current status of a lower fork into the panic table indicated by 
the A register. It does not influence the operation of the fork in any way. 


quantum. It guarantees that the next time he is started he will hove a complete short time 
quantum. See BRS 57 to guarantee 16 msec. 

REGISTERS AFFECTED: None 




REGISTERS AFFECTED: None 
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NUMBER: 72 

NAME: EXDM5 

FUNCTION: System Fork Dismissal 



CALLING SEQUENCE: LDX 
BRS 



N The number of the queue that the fork is to be put on. 

DESCRIPTION: Dismisses a system fork and puts it on the specified queue. Returns to call 
+ 1 when recalled. The reoctivction condition must be in the Monitor. This BRS is used to 
dismiss the Phantom User. 

Teletype queue 

1 I/O queue 

2 Short time quantum queue 

3 Long time quantum queue 
REGISTERS AFFECTED: None 



NUMBER: 81 

NAME: WREAL 

FUNCTION: Dismiss for Specified Amount of Time 

STATUS: User 

CALLING SEQUENCE: LDA T 
BRS 81 

T Dismissal time in milliseconds. 

DESCRIPTION: The fork is dismissed for the number of milliseconds specified in A. See 
BE+12 

REGISTERS AFFECTED: A 



NUMBER: 31 

NAME: FKWT 

FUNCTION: Wait for Fork to Cause a Panic 

STATUS: User 



CALLING SEQUENCE: LDA 
BRS 



P Panic Table Address 

DESCRIPTION: Causes the controlling fork to be dismissed until the lower fork, or forks, 
causes a panic. When it does, the controlling fork is reactivated at Hie instruction follow- 
ing this BRS, and the panic table contains the status of the fork on its dismissal. The status 
is also put into the X register. The panic table address is put into the A register. 

The controlling fork must have armed an interrupt or a lower fork must execute a BRS 10. 

REGISTERS AFFECTED: X, A 



NUMBER: 106 

NAME: FKWA 

FUNCTION: Wait for Any Fork to Terminate 

STATUS: User 

CALLING SEQUENCE: BRS 106 

DESCRIPTION: Fork is dismissed until some lower fork terminates. When a lower fork ter- 
minates, the panic table address will be left in A. 

REGISTERS AFFECTED: None. 
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NUMBER: 109 


NUMBER: 32 


NAME: DMS 


NAME: FKTM 


FUNCTION: Dismiss 


FUNCTION: Terminate a Fork 


STATUS: User 


STATUS: User 


CALLING SEQUENCE: BRS 109 


CALLING SEQUENCE: LDA P 


DESCRIPTION: The fork is dismissed. It can only be activated again by a program inter- 
rupt which has been armed by this fork or the termination of a lower fork. 


BRS 32 
P Panic Table 


REGISTERS AFFECTED: None. 


DESCRIPTION: Causes a lower fork to be unconditionally terminated and its status to be 
stored into the panic table. The X register contains the status word upon return. 




REGISTERS AFFECTED: X 


NUMBER: 10 


NUMBER: 73 


NAME: PPAN 


NAME: EPPAN 


FUNCTION: Programmed Panic. Terminates a Fork. 


FUNCTION: Economy Panic 


STATUS: User 


STATUS: User 


CALLING SEQUENCE: BRS 10 


CALLING SEQUENCE: LDA N 


DESCRIPTION: BRS 10 terminates the fork that Issues it and returns control to the higher 
fork. It is like typing "escape" on the teletype. This condition can be distinguished from 


BRS 73 
N Number of forks to terminate. 


panic caused by the escape key only by the fact that in the former case the program 
counter in the panic table points to a word containing BRS 10. This BRS would normally be 
used to terminate a fork when it is finished. The information in the panic table would, 
therefore, only be useful to a higher fork or to this fork if interrupt 4 has been armed by 
this fork. 


DESCRIPTION: This is like doing a BRS 10 for each of the forks specified. Forks are ter- 
minated going up until the Executive fork is reached or until N forks have been terminated. 
REGISTERS AFFECTED: None. 


REGISTERS AFFECTED: None 
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NUMBER: 108 

NAME: FKTA 

FUNCTION: Terminates All Forks 

STATUS: User 

CALLING SEQUENCE: BRS 108 

DESCRIPTION: All lower forks are terminated and their status read into the corresponding 
panic tables. 

REGISTERS AFFECTED: None 
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21. INPUT/OUTPUT 



NUMBER: 1 

NAME: MONOPN 

FUNCTION: Open a File of a Specific Device 

STATUS: System 

CALLING SEQUENCE: LDA ±1 

LDB ±L (BCDTAPE output only) 

LDX D 

BRS 1 

EXCEPTION RETURN 

NORMAL RETURN 

File number will be in register A on Normal Return. 

I The relative address (DSU Address MOD 4) of the file's Index block for DSU files, 
or unit number for magnetic tape, otherwise anything. (1 = for a new output file 
since the Index Block address is unknown.) 

Make the file read only. 

+ Make the file read/ write. 

D Device number. 

L + for 80 char, records, - for 132 char, records. 

Available device numbers are as follows: 

1. Paper tape input. 

2. Paper tape output. 

3. BCD tape input. 

4. Magnetic tape input. 

5. Magnetic tape output. 

6. Card input BCD. 

7. Card input BIN. 

8. Sequential DSU input. 

9. Sequential DSU output. 
10. BCD tape output. 
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NUMBER: 110 




1 1. Line printer. 


NAME: RDU 




12. Card punch BCD 


FUNCTION: Read Device and Unit 




\3. Card punch BIN 


STATUS: User 




DESCRIPTION: The "open file" BRS is used to condition a file for input or output processing. 
If the file is successfully opened, control is transferred to the normal return with A continu- 
ing the file number; otherwise control is transferred to the exception return. Exception con- 


CALLING SEQUENCE: LDA FILE No. 
BRS 110 
NORMAL RETURN 




ditions are as follows: 

1. Device or file in use or not available. 


DESCRIPTION: Output X device number. 
A unit number. 




2. Too many files open. 


See BRS 1 for device number description. 




3. No disc space left. 


REGISTERS AFFECTED: A, X 




A file may be opened for Input any number of times for the purpose of multiple user access or 
multiple processing by a single user. A file that is opened for output must be closed before 
it is opened. See also, BRSs 2, 3, 20, 82. 






REGISTERS AFFECTED: A, X 








NUMBER: 2 






NAME: MONCLS 






FUNCTION: Close a File 






STATUS: User 






CALLING SEQUENCE: LDA N 
BRS 2 
NORMAL RETURN 






N File number (obtained when file was opened). 






DESCRIPTION: The "close file" BRS is used to indicate to the system a 
pleted on this file. All necessary termination processing will be comple 
be transferred to the normal return. See BRS 20. 


1 processing is com- 
ted and control will 




REGISTERS AFFECTED: None 
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NJMBER: 20 



NAME: CFILE 




FUNCTION: Close a FiU 




STATUS: User 




CALLING SEQUENCE: LDA 


N 


BRS 


20 


N File Number 





DE:SCRlPTION: The "close file" BRS is used to indicate to the system ell processing is 
completed on this file. If the file number indicates magnetic tape, the file will be termina- 
ted and,if output, the End of File will be written; but in either case, the tape will be posi- 
tioned at the start of the next file and the tape is de-allocated. All registers are changed. 

REGISTERS AFFECTED: All 



NUMBER: 8 

NAME: lOH 

FUNCTION: Close all Files 

STATUS: User 

CALLING SEQUENCE: BRS 8 

NORMAL RETURN 

DESCRIPTION: The "clo'.e all files" BRS is used to indicate the the system that all processing 
is completed on all files. The system will complete all necessary termination processing on 
all files and transfer contiol to the normal return. BRS 8 is always executed when control 
returns to the system. This BRS will not close magnetic tape files correctly. See BRS 1, 2, 
82, and 17. 

REGISTERS AFFECTED: None 
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NUMBER: 66 
NAME: DFDL 
FUNCTION: Delete DSU File Data 



STATUS: User 
CALLING SEQUENCE: 



N File Number 



LDA N 

BRS 66 

NORMAL RETURN 



DESCRIPTION: This BRS will return to available storage all DSU blocks which ore assigned 
to the indicated file and clear the index block of DSU addresses. This BRS does not release 
the index block nordoesitdelete the file directory entry from the Customer File Directory. 

REGISTERS AFFECTED: None 



NUMBER: 67 

NAME: DFER 

FUNCTION: Delete a Specified Block of the DSU 

STATUS: System 

CALLING SEQUENCE: LDA D 
BRS 67 

NORMAL RETURN 

D Address of the DSU block. 

DESCRIPTION: This BRS will return the DSU block indicated by the address in register A to 
available storage and transfers control to the normal return. This BRS should be used to de- 
lete Index Blocks. The BRS does not clear the Index Block address from the Customer File 
Directory, nor does it delete the file entry from the Customer File Directory. 

REGISTERS AFFECTED: None 
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NUMBER: 87 


NUMBER: 105 


NAME: DFRX 


NAME: WSYB 


FUNCTION: Read DSU File Index Block 


FUNCTION: Write a Page on the RAD 


STATUS: System 


STATUS: System 


CALLING SEQUENCE: LDA D 
LDX W 
BRS 87 
NORMAL RETURN 


CALLING SEQUENCE: LDA C 
LDB R 
BRS 105 
NORMAL RETURN 


D DSU address of the index block (MOD 4) 

W Core address into which the block is to be read. 


DESCRIPTION: Writes one page on the RAD starting at the address R from a page in core. 
C may be any location in that page. The data will start in the first word of the page. 


DESCRIPTION: Reads the specified block into the given core location and transfers control 
to the normal return. The block read is the size of the currently defined index block. The 
size of an index block varies with the assembly. 


Uncorrectable RAD errors result in an instruction trap or interrupt 1 1, if it is armed. Try 
command again. 


REGISTERS AFFECTED: None 


REGISTERS AFFECTED: None 


NUMBER: 104 


NUMBER: 113 


NAME: RSYB 


NAME: DFCD 


FUNCTION: Read a Page from the RAD 


FUNCTION: Compute File Size of a DSU File 


STATUS: System 


STATUS: User 


CALLING SEQUENCE: LDA C 


CALLING SEQUENCE: LDA File Number 


LDB R 


BRS 113 


BRS 104 


NORMAL RETURN 


C Core Address 

R RAD Address 

DESCRIPTION: Reads one page from the RAD starting at the address R into a page in core. 
C may be any location in that page. The data will start in the first word of the page. 


DESCRIPTION: Adds the number of data words (in multiples of 255) in the file to the num- 
ber in the X register. Returns the result in X. 

REGISTERS AFFECTED: X 


Uncorrectable RAD errors result in an Instruction trap or interrupt 11 if it is armed. Try com- 
mand again. 




REGISTERS AFFECTED: None 
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NUMBER; 118 


NUMBER: BE+9 




NAME: TGET 


NAME: RDSYB 




FUNCTION: Allocate Magnetic Tape Unit 


FUNCTION: Read DSU Page 




STATUS: System 


STATUS: System 




CALLING SEQUENCE: LDA Tape Number 
BRS 118 
EXCEPTION RETURN 
NORMAL RETURN 

DESCRIPTION: Assigns the tape requested to the user. If the tope is already busy with someone 
else the exception return is executed. 

REGISTERS AFFECTED: None 


CALLING SEQUENCE: LDA C 
LDB R 
BRS BE+9 

C Core Address 
R Disc Address 

DESCRIPTION: Use like 105. Can only be called by the Executive, 
perform this function if less than a page is to be written. 

REGISTERS AFFECTED: None 


BE+2 can be used to 


NUMBER: 119 


NUMBER: BE + 10 




NAME: TREL 


NAME: WDSYB 




FUNCTION: De-allocate Magnetic Tape Unit 


FUNCTION: Write DSU Page 




STATUS: System 


STATUS: System 




CALLING SEQUENCE: LDA Tape Number 
BRS 119 
NORMAL RETURN 


CALLING SEQUENCE: LDA C 
LDB R 
BRS BE+10 




DESCRIPTION: Releases the tape specified. 
REGISTERS AFFECTED: None 


C Core Address 
R RAD Address 

DESCRIPTION: Use like 104. Con only be called by the Executive, 
perform this function if less than a page is to be read. 

REGISTERS AFFECTED: None 


BE+I can be used to 
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NUMBER: BE+7 

NAME: BPTEST 

FUNCTION: Test a Breakpoint Switch 

STATUS: System 

CALLING SEQUENCE: LDX Switch Number 

BRS BE+7 

SWITCH UP RETURN 
SWITCH DOWN RETURN 

DESCRIPTION: Tests the breakpoint switch (1, 2, 3, 4) indicated in X. If the switch is 
down, the BRS skips on return. 

REGISTERS AFFECTED: None 



NUMBER: BE+1 
NAME: ARD 
FUNCTION: Read DSU 
STATUS: System 
CALLING SEQUENCE: 



NORMAL RETURN 

DESCRIPTION: Reads up to 2K words from the disc. Transfer must not cross a page boundary 
and must be in multiples of 16 words. Errors result in on instruction trap or programmed inter- 
rupt 1 1, if it i< armed. No two forks that ore to run simultaneously should both use this BRS. 

REGISTERS AFFECTED: None 



LDA 


Core Address 


LDB 


Disc Address 


LDX 


Number of Words 


BRS 


BE+1 
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NUMBER: BE+2 




NAME: AWD 




FUNCTION: Write DSU 




STATUS: System 




CALLING SEQUENCE: LDA 


Core Address 


LDB 


Disc Address 


LDX 


Number of Words 


BRS 


BE+2 



DESCRIPTION: Like BRS BE+1. The number of words must be a multiple of 64. 
REGISTERS AFFECTED: None 



NUMBER: BRS BE+15 

NAME: RDPGE 

FUNCTION: Read an SMT page from RAD 

STATUS: SYSTEM 



CALLING SEQUENCE: LDA 
BRS 



N 
BE+15 



N 



SMT 



nber 



DESCRIPTION: Reads an SMT page from the RAD. The page must already be in memory. It 
returns the RAD address in B if a read occurs; otherwise there Is no change. The purpose of 
this BRS is to read in another copy of the page in the event that the copy of the page in core 
has been altered. 

REGISTER AFFECTED: B 
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NUMBER: BE+17 

NAME: CKBUF 

FUNCTION: Test for last buffer free 

STATUS: User 

CALLING SEQUENCE: BRS BE+17 

DESCRIPTION: If a buffer in fhe user's TS block is available, the program continues 
If not, an instruction trap will occur. 

REGISTERS AFFECTED: None 



NUMBER: BRS BEfl9 

NAME GTFDT 

FJNCTION: Get creation date, access count for a file 

STATUS: System 

CALLING SEQUENCE: IDA L 

BRS BE+19 

L Address in file directory hash table that corresponds to this file. (See contents of 

A register on normal return from BRS 37) 

DESCRIPTION: Extracts the creation date and the access count for a file. A — creation date; 
B — access count. 

REGISTERS AFFECTED: A and B 
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NUMBER: 15 

NAME: GFN 

FUNCTION: Reads Input File Nome from a Command File and Looks up the File Name in 
the User's File Directory. 

STATUS: User 

CALLING SEQUENCE: LDA N 
BRS 15 

EXCEPTION RETURN 
NORMAL RETURN 

N Command File Number 

DESCRIPTION: The routine ignores leading spoces, leading multi-blanks, and leading car- 
riage return characters. It then uses the BRS 37 to look up the file name in the user's file 
directory hash table. '^ It returns in the registers for both returns exactly what BRS 37 
puts there, which is: 

Exception Return: X Pointer to the input file name string pointers 

A &B Input file name string pointers 
Normal Return: A Pointer to the string pointers of the desired file in the 

file directory hash table 

B The value word of the hash table entry 

X Changed 

Note: The information contained in the registers cannot be used directly by the user since 
the addresses are in the TS Block; this BRS is normally followed by the BRS 16. 

If the input file name string begins with a left parenthesis, or with the full quote, 
the file name will be located in another user's file directory or in the public file 
directory, respectively; in these cases, the input command file must be the teletype. 
Since the BRS 37 is not used in this case, the information in the registers is of no 
practical use to the user, and the BRS must be followed by the BRS 16 as indicated 
under the BRS 16. 

REGISTERS AFFECTED: None 



The exception return is taken if the input file name string cannot be located in the file 
directory. 
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NUMBER: 16 

NAME: GIFNB 

FUNCTION: Open Input File in File Directory. 

STATUS: User 

CALLING SEQUENCE: 



LDA 


N 


BRS 


15 


BRU 


(Error) 


BRS 


16 



EXCEPTION RETURN 
NORMAL RETURN 

N Command file number 

DESCRIPTION: Opens an input file locoted in the user's file directory. BRS 16 requires 
the location of the first word of the entry in the file directory hash table. The exception 
return is taken if the pointer in A is not pointing to a proper location in the hash table, or if 
the file cannot be opened for any reason, such a physical device that cannot be an input file. 
The file directory pointer may be obtained from a BRS 15 or a BRS 18. 



Exception Return: 
Normal Return: A: 



REGISTERS AFFECTED: All 



All registers changed 
File Number 
File Type (0-4) 
File Size 



NUMBER: 17 

NAME: UABORT 

FUNCTION; Close all Files (Including magnetic tape) 

STATUS: User 

CALLING SEQUENCE: BRS 17 

DESCRIPTION: If magnetic tape has been used, the last record will be terminated and if 
output, the End of File will be written; in either cose, the tape will be positioned at the 
start of the next file. The tape is then closed and the unit is de-allocated. See BRS 8. 
All registers are changed. 

REGISTERS AFFECTED: All 
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NUMBER: 18 

NAME: GOFNA 

FUNCTION: Reads File Name from a Command File and Looks Up the File Name in the 
User's File Directory. The Command File Must Be an Input File. 

STATUS: User 

CALLING SEQUENCE: LDA N 
BRS 18 

EXCEPTION RETURN 
NORMAL RETURN 

N - Command File Number 

Bit 1 = 1 of A Register = Assume a file name is correct and does not type "OLD FILE" or 

"NEW FILE". 

DESCRIPTION: The routine ignores leading spaces, leading multiblanks, and leading carriage 
return choracters. If the string begins and ends with a single quote or a slash, the string is 
terminated for look-up with this character and the string is looked up in the user's file di- 
rectory using the BRS 5. A confirming carriage return must follow the quote or slosh before 
the string is looked up. The exception exit is taken if the character is not a carriage return. 
If the string is found in the file directory hash table, the message "OLD FILE" is typed, 
otherwise the message "NEW FILE" is typed. If a confirming line feed, carriage return, or 
period is then next in the input string, the normal return will be taken, otherwise the ex- 
ception return. In the case of a new file, the file name is inserted conditionally into the 
file directory. 

If the string begins with a character other than a single quote or a slash, the string is looked 
up in the user's file directory using the BRS 37. If the string is not located, the error exit is 
immediately taken causing the exception return. The exception return will also be caused 
if the file is read only as indicated by the flag in the file directory. 

Exception Return: All registers changed. 

Normal Return: A; Location of the file in the directory hash table. 

B: Confirming character in case of a quote or slash file; 

otherwise, the file directory hash table value word. 

X: Changed. 

REGISTERS AFFECTED: All 
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NUMBER: 19 

NAME: GOFNB 

FUNCTION: Open Output Ffle Located in File Directory 

STATUS: User 



CALLING SEQUENCE: LDA 
LDB 
LDX 
BRS 



Nl 



N2 (For Tape Files Only) 

N3 

19 

EXCEPTION RETURN 
NORMAL RETURN 



Nl Information supplied In A by BRS 18 (location in the file directory). 
N2 File Size (as supplied in X by BRS 16) for tape files only. 
N3 File Type (as supplied in B by BRS 16). 

DESCRIPTION: Opens an output file located in the user's file directory. The information 
required in the register is indicated above. The word in A is checked for legality. If it is 
not a valid pointer, the exception return is taken. The exception return is also taken if the 
file cannot be opened for any reason, such as a physicol device that cannot be used for out- 
put, in the case of a new file, the file directory entry is completed. If the new file is o 
DSU file and it cannot be opened, the message "NO ROOM" is typed. The message "FILE 
TYPE WRONG" is typed as appropriate. 

Exception Return: All changed. 
Normal Return: A File Number. 

B S, X Changed. 

REGISTERS AFFECTED: All 
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NUMBER: 48 

NAME: GSFN 

FUNCTION: Look up Input/Output File Nome 

STATUS: User 

CALLING SEQUENCE: LDP N 
BRS 48 

EXCEPTION RETURN 
NORMAL RETURN 

N String pointers for the file name. 

DESCRIPTION: The file name is looked up in the file directory hash table using the BRS 5. 
If it is not there, the exception return is token. 



Exception Return: A & B: 

X: 
Normal Return: A & B: 

X: 
REGISTERS AFFECTED: All 



No change. 

Changed. 

Location in file directory hash table. Can be used by 

BRS 16 or BRS 19. 

Changed. 



NUMBER: 60 

NAME: GSFI 

FUNCTION: Look Up Input/Output File Name and Insert if New. 

STATUS: User 

CALLING SEQUENCE: LDP N 
BRS 60 

EXCEPTION RETURN 
NORMAL RETURN 

N String pointers for the file name. 

DESCRIPTION: The file name is looked up in the file directory hash table using the BRS 5. 
If it is not there, it is inserted in the hash table. The exception return is taken if it cannot 
be inserted in the case of a full directory. 

Exception Return: A & B: No change. 

X: Changed. 

Normal Return: A & B: String pointer to location in file directory hash table. 

X: Changed. 
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NAME: CIO 

FUNCTION: Character input/Output 

STATUS: User 



CALLING SEQUENCE: 



LDA 
CIO 



C (Output only) 
N 



C 8 bit data character right justified. 

N Address of word containing a file number. 

DESCRIPTION: CIO is used to input or output a single character from, or to, a file from 
the A register. On input an End of Record or End of File condition will set bits and 8 
or bits and 7 in the file number and return a 134g or 137g character, respectively. If in- 
terrupt 4 is armed (see BRS 78), it will occur. The End of Record occurs on the next input 
operation after the last character of the record has been input and the E nd of File condition 
occurs on the next input operation after the End of Record which signals the last record of 
the file. If an error occurs, bits and 6 will be set in N and interrupt 4 will occur if it is 
armed. 

WIO and BIO should not be mixed with CIO to read or write a given file. 

REGISTERS AFFECTED: A 



NAME: WIO 

FUNCTION: Word Input/Output 

STATUS: User 



CALLING SEQUENCE: LDA 
WIO 



D (Output only) 
N 



D Data word to be written. 

N Address of word containing a file number. 

DESCRIPTION: WIO is used to input or output a word of data to or from the A register. On 
input on End of Record condition returns a word of three 1348 characters and sets bits and 
8 in the file number word. If interrupt 4 is armed (see BRS 78), it will occur. An End of 
File condition returns a word of three 137B characters and sets bits and 7 in the file num- 
ber word. If interrupt 4 is armed, it will occur. If an End of Record or File condition oc- 
curs with a partially filled out word, the word is completed with 1348 or 1378 characters. 
If an error occurs, bits and 6 ore set in N. If interrupt 4 is armed it will occur. 

CIO and WIO should not be mixed to read or write a given file. 

REGISTERS AFFECTED: A 
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NAME: BIO 

FUNCTION: Blocked Input/Output 

STATUS: User 

CALLING SEQUENCE: 



LDA W 

LDX I 

BIO N 

EXCEPTION RETURN 
NORMAL RETURN 

I Starting memory address. 

W Number of words to be read or written. 

N Address of word containing a file number. 

DESCRIPTION: BIO is used to input a block of words to memory or output a block of words 
from memory. The A register will contain the first memory location unaffected at the end 
of the operation. If the operation is completed successfully, control will be transferred 
to the normal return, otherwise control will be transferred to the exception return. 

On input on End of Record or End of File condition will set bits and 8 or and 7 respec- 
tively in the file number. An error will set bits and 6. Interrupt 4 will occur if armed, 
when any of these bits are set. Exception conditions are end of record, end of file, and 
bad record. 

If bit 1 is set in the Data Block disc address in the Index Block of a DSU file, it indicates 
the end of the data blocks and is the end of a logical record. 

REGISTERS AFFECTED: A, X 
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NAME: CTRL 

FUNCTION: Input/ Outp'jt Control (for paper tape and magnetic tape only) 

STATUS: System 



CALLING SEQUENCE: LDB 


N 


LDA 


C 


CTRL 


N 


C Control number 




N File number 




Nl Number for control 3 


or 4 



DtSCRIPTlON: CTRL provides the following control functions for tope files; 



Control 

1 

2 
3 
4 
5 
6 
7 



Description 

Write end of record on output. Record count not used. 

Bockspace physical block. 

Forward space (B) files. 

Backspace (B) files. 

Erase tape (output only) (3 inches). 

Rewind. 

Write EOF. Output only. 

Long erase. Output only. 



REGISTERS AFFECTED: None 
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22. TELETYPES 



NUMBER: 23 

NAME: INKS 

FUNCTION: Link Teletypes 

STATUS: System 

CALLING SEQUENCE: LDA 
BRS 



EXCEPTION RETURN 
NORMAL RETURN 

T Teletype Number 

DESCRIPTION: This BRS will link the controlling teletype with the teletype specified in the 
A register. The exception return will occur if: the teletype specified by T is already linked; 
is in the 8-level mode; does not have the accept message bit set; or has the XOFF, XON, or 
P bits set in TTYBL. If the exception return occurs, the A register will contain either the 
number of the teletype that is currently linking to the teletype specified by T or A will con- 
tain the TTYBL word for teletype T for all other conditions. The controlling teletype number 
will then be placed into bits 1 through 7 of the LCW word of teletype T. 

If the normal return occurs, bit of LCW of both teletypes will be reset and bits 18 through 
23 will contain the linked teletype number. 

REGISTER AFFECTED: A 



NUMBER: 24 

NAME: LNKC 

FUNCTION: Break teletype link 

STATUS: User 

CALLING SEQUENCE: LDX T 

BRS 24 

T Teletype Number 

The controlling teletype link with the teletype indicated by bits 18-23 of LCW is broken 
(i.e., bit Oof the LCW word for both teletypes is set). 

REGISTERS AFFECTED: None 
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NUMBER: 27 


NUMBER: 25 


NAME: ASTT 


NAME: MSGS 


FUNCTION: Attach TTY to this program 


FUNCTION: Accept/Refuse Messages (links) 


STATUS: System 


STATUS: User 


CALLING SEQUENCE: LDA T 


CALLING SEQUENCE: LDX T 


BRS 27 


LDA I 


EXCEPTION RETURN 


BRS 25 


NORMAL RETURN 


T Any teletype number (-1 to indicate controlling teletype) 


T Teletype Number 


I Bit 22 set to accept messages (links) 
Bit 22 reset to refuse messages (links) 
Bit 23 set to accept input 
Bit 23 reset to refuse input 


DESCRIPTION: To give total control over a teletype to the requesting program. If the 
indicated type is free, it is attached to the requesting program and transfers control to the 
"normal return". If it is not free, control is transferred to the "exception return". 


DESCRIPTION: This BRS will set or reset bit 8 (the accept input bit) and/or bit 9 (the 


REGISTERS AFFECTED: None 


accept message bit) of the TTYBL word for the teletype indicated by the X register. 




REGISTERS AFFECTED: None 


NOT IMPLEMENTED 




NUMBER: 28 




NAME: RSTT 




FUNCTION: Release TTY 




STATUS: System 




CALLING SEQUENCE: LDA T 




BRS 28 




T Teletype Number 




DESCRIPTION: Returns to a free status the teletype indicated by the A register. If the 




teletype was not attached to the requesting program a "panic" will be executed. 




Note: All attached teletypes are releosed when the user lops out. 




REGISTERS AFFECTED: None 




NOT IMPLEMENTED 
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NUMBER: 11 


NUMBER: 29 




NAME: CIB 


NAME: COB 




FUNCTION: Clear the Teletype input Buffer 






STATUS: User 


FUNCTION: Clear the Output Buffer 
STATUS: User 




CALLING SEQUENCE: LDX T 






BRS 11 


CALLING SEQUENCE: LDX T 
BRS 29 




1 Teletype number (-1 is used to indicate the controlling teletype). 


T Teletype Number (-1 indicates the controlling TTY). 




DESCRIPTION: Sets the buffer pointers to indicate there are no characters in the teletype 




input buffer. 


DESCRIPTION: Sets the buffer pointers to indicate there are no characters in the teletype 
output buffer. 




REGISTERS AFFECTED: None 


REGISTERS AFFECTED: None 






NUMBER: 12 






NAME: CET 

FUNCTION: Declare Echo Table 






NUMBER: BE+6 


STATUS: User 




NAME: TTYON 


CALLING SEQUENCE: LDX T 
LDA R 




FUNCTION: Turns a Teletype Line On or Off. 


BRS 12 




STATUS: System 


T Teletype number (-1 is used to indicate the controlling TTY). 




CALLING SEQUENCE: LDA ==TTYNo. 


R ± 1, 2, or 3 to indicate the proper echo table. If the sign bit of R is set, each 8 




LDB =0 (off) or -1 (on) 


bit character read from the teletype is transmitted unchanged to the user's program. 




BRS BE+6 
NORMAL RETURN 


No echoes are generated while in this special 8-level mode. Teletype output is 
not affected. 




DESCRIPTION: Issues the EOM and POT commands which cause the line to be turned off 


DESCRIPTION: BRS 12 sets the echo table for the TTY indicated by register X. Echo tables 




(hung up) or made ready to accept an incoming call. 


are as follows: 




REGISTERS AFFECTED: None 


Echo each character just as it was received and break on all characters. 

1 Same echo as but all characters except letters, digits and spaces are break 
characters. 

2 Same echo as 0, but the only break characters are control characters (including 
carriage return and line feed). 

3 No echo for any character and break on all characters. 
REGISTERS AFFECTED: None 
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NUMBER: 40 

NAME: RDET 

FUNCTION: Read Echo Table 

STATUS: User 

CALLING SEQUENCE: LDX 
BRS 



T Teletype number 

DESCRIPTION: Reads the echo table number (0, 1, 2, 3) into the A register. 

If the teletype is not in 8-level input mode, reads the echo table number (0, 1, 2, 3) into 
the A registeir. If the teletype is in 8-level input mode, the sign bit of A is set, the address 
field contains the terminal character. 

REGISTER AFFECTED: A 



NUMBER: 13 

NAME: SKI 

FUNCTION: Test Input Buffer for Empty 

STATUS: User 

CALLING SEQUENCE: LDX T 
BRS 13 

EXCEPTION RETURN 
NORMAL RETURN 

T Teletype number (-1 is used to indicate the controlling TTY). 

DESCRIPTION: This BRS tests for the presence of input characters in the buffer. If the buf- 
fer is empty, control is transferred to the "normal return". If there are any characters in 
the input buffer, control is transferred to the "exception return". 

REGISTERS AFFECTED: None 
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NUMBER: 14 

NAME: DOB 

FUNCTION: Dismiss Until the Teletype Output Buffer is Empty. 

STATUS: User 



CALLING SEQUENCE: LDX 
BRS 



T 
14 



T Teletype number (-1 is used to indicate the controlling user TTY). 

DESCRIPTION: Dismiss this fork until the teletype output buffer indicated is empty. It is 
dismissed only until the last character is transmitted. Caution should be exercised as this 
fork might be restarted before the last character interrupt has occurred. 

REGISTERS AFFECTED: None 



NUMBER: 85 

NAME: SET8P 

FUNCTION: Set Special Teletype Input/Output 

STATUS: User 



CALLING SEQUENCE: LDX 
BRS 



T Teletype number (-1 is used to indicate controlling user TTY). 

DESCRIPTION: Sets teletype to 8-level input/output mode. The teletype specified must 
either be the controlling teletype or an attached teletype. 8-level is transmitted to or 
from the teletype exactly as it is received from the user program. 

REGISTERS AFFECTED: None 



NUMBER: 86 

NAME: CLR8P 

FUNCTION: Clear Special Teletype Input/Output 

STATUS: User 

CALLING SEQUENCE: LDX T 
BRS 86 

T Teletype number (-1 is used to indicate controlling user TTY). 

DESCRIPTION: Restores teletype output to normal mode. The teletype specified must 

either be the controlling teletype or attached to it. 

REGISTERS AFFECTED: None 



NAME: TCI 

FUNCTION: Teletype Character Input 

STATUS: User 

CALLING SEQUENCE: TCI M 

M Memory address 

DESCRIPTION: This SYSPOP reads the character from the teletype input buffer and places 
it into location M right justified. The remainder of location M is cleared. The char- 

acter is also placed in the A register right justified. 

REGISTER AFFECTED: A 
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NAME: TCO 

FUNCTION: Teletype Character Output 

STATUS: User 

CALLING SEQUENCE: TCO M 

M Memory address 

DESCRIPTION: This SYSPOP outputs the character from the right-most 8 bits of location M 
to the controlling teletype. In addition to the ordinary ASCII characters, all teletype out- 
put operations will accept 135B as a multiple blank character. The next character will be 
taken as a blank count, and the indicated number of blanks will be typed. 

REGISTERS AFFECTED: None 



NAME: OST 

FUNCTION: Output to Specified Teletype 

STATUS: User 

CALLING SEQUENCE: OST T 

T Teletype number 

DESCRIPTION: OST is used to output a character in the A register to a specified teletype. 
This instruction is used for output to an attached teletype. Its accept message bit must be 
set or an illegal instruction panic will be generated. 

REGISTERS AFFECTED: None 



NOT IMPLEMENTED 
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23. MEMORY 


NUMBER: 120 

NAME: APMTE 

FUNCTION: Assign PMT Entry 




NUMBER: 4 


STATUS: System 




NAME: MPT 


CALLING SEQUENCE: LDA R 




FUNCTION: Release a Page of Memory 


BRS 120 




STATUS: User 


R Relabeling byte 




CALLING SEQUENCE: LDA N 
BRS 4 


DESCRIPTION: Obtains a new page for tfie relabeling byte specified, 
only in the recover routine in the executive. 


This BRS is used 


N Contains any address in the page to be released. 


Instruction Trap: 




DESCRIPTION: The PMT entry for the block is removed and the byte in any other fork 
which has this PMT byte, in its relabeling is cleared. 


1. PMT entry is already assigned. 

2. The relabeling byte number was not in the PMT. 




REGISTERS AFFECTED: None 


REGISTERS AFFECTED: None 




NUMBER: 121 


NUMBER: 43 




NAME: DPMTE 


NAME: RDRL 




FUNCTION: Release Specified PMT Entry 


FUNCTION: Read Pseudo-Relabeling 




STATUS: User 


STATUS: User 




CALLING SEQUENCE: LDA R 


CALLING SEQUENCE: BRS 43 




BRS 121 


DESCRIPTION: Reads the current pseudo-relabeling registers into rag 


sters A and B. 


R Relabeling byte 


REGISTERS AFFECTED: A, B 




DESCRIPTION: Releases the specified page from the PMT. It is similar to a BRS 4 






except that it takes a byte number instead of an address. 






Instruction Trap: 






1. Byte not in PMT. 






2. A user fork tried to release a system page. 






REGISTERS AFFECTED: None 
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NUMBER: 44 


NUMBER: 117 


NAME: STRL 


NAME: SURL 


FUNCTION: Set Pseudo-Relabeling 


FUNCTION: Set User Relabeling 


STATUS: User 


STATUS: System 


CALLING SEQUENCE: LDA Rl 
LDB R2 
BRS 44 


CALLING SEQUENCE: LDA RLl 
LDB RL2 
BRS 117 


Rl & R2 Relabeling factors 


RLl and RL2 are the new values for the program relabeling. 


DESCRIPTION: This BRS takes the contents of registers A and B and stores them into the 
current pseudo-relabeling registers. It also causes the real relabeling to be reset to corre- 


DESCRIPTION: Sets the program relabeling as specified. This BRS is used by the system. 
User programs should use BRS 44 to set relabeling for a fork. 


spond to the new pseudo-relabeling. 


Instruction Trap: 


This BRS will result in an instruction trap for any of the following reasons: 


1. A specified relabeling byte was not assigned. 


1. Swapping in the new pages was not completed (usually because of a RADfailure). 


2. A user fork tried to relabel a system byte. 


2. The user tried to relabel over a system page. 

3. The user tried to relabel over a page he did not have. (This is not the way to 


REGISTERS AFFECTED: None 


obtain more memory.) 




REGISTERS AFFECTED: None 




NUMBER: 116 


NUMBER: 122 


NAME: RURL 


NAME: MPAN 


FUNCTION: Read User Relabeling 


FUNCTION: Simulate Memory Panic 


STATUS: System 


STATUS: System 


CALLING SEQUENCE: BRS 116 

C)ESCRIPTION: Puts the program relabeling into A and B. This is what the system Execu- 
tive uses as program relabeling. It is kept in the TS block. 


CALLING SEQUENCE: LDA A 
BRS 122 

A Core address 


REGISTERS AFFECTED: A, B 


DESCRIPTION: This BRS gets new memory for a class 3 BRS. If it succeeds the new memory 
is put into the relabeling of the calling program. Con be issued from a class 3 BRS only. 




If a memory trap occurs, it looks to the calling program as if it came from a BRS 




instruction. 




REGISTERS AFFECTED: None 
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NUMBER: 56 


NUMBER: BE+4 




NAME: MBEX 


NAME: PEBRS 




FUNCTION: Make Page System 


FUNCTION: Reads or Sets One Word in the Monitor 




STATUS: System 


STATUS: System 




CALLING SEQUENCE: LDA P 
BRS 56 


CALLING SEQUENCE: LDA V 

LDB or -1 

LDX =Location in Monitor relabeling 




P Pseudo-Relabeling byte for page. 


BRS BE+4 




If bit of A = 1, page will be made system. 


RETURN 




If bit of A = 0, page will be made not system. 


V New value for word if it is to be set. 


, 


DESCRIPTION: Sets the use mode of a page depending on the value of bit in the A 


The contents of the location are returned in the A register. 




register. 


If B is positive, the word is read. 




Bit of A is set to 1 if poge was formerly system or if it was not. 


If B is negative, the word is changed and the old value returned in A. 




REGISTER AFFECTED: A 


DESCRIPTION: Allows a system program to read or set the contents of any location 
monitor relabeling. 

The original contents of the location are always returned in the A register. 

REGISTER AFFECTED: A 


in the 


NUMBER: 80 


NUMBER: 68 




NAME: MBRO 


NAME: EBSM 




FUNCTION: Make Page Read Only 


FUNCTION: Enter Block in SMT 




STATUS: User 


STATUS: System 




CALLING SEQUENCE: LDA P 
BRS 80 


CALLING SEQUENCE: LDA B 
BRS 68 




P PMT/SMT number 


B Byte number in users pseudo-relabeling 




If bit of A = 1, make page read only. 


DESCRIPTION: A free SMT entry is found and the PMT entry put into it. The SMT 


number 


If bit of A = 0, make page read-write. 


is returned in A. 




DESCRIPTION: Sets the read-write status of the entry according to the value of A. An 


REGISTER AFFECTED: A 




SMT entry can only be changed by a system fork. The former status of the entry is returned 
in A. 






Instruction Trap: 


NOT IMPLEMENTED 




1. Specified entry is not in use. 






2. The swap failed. 






REGISTER AFFECTED: A 
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NUMBER: 69 




24. STRING PROCESSING 


NAME; GBSM 






FUNCTION: Get SMT Block to PMT 






STATUS: Subsystem 




NUMBER: 33 


CALLING SEQUENCE: LDA S 




NAME: GETSTR 


BRS 69 




FUNCTION: Read String 


S SMT number 




STATUS: User 


DESCRIPTION: Puts the SMT entry into 


the first free PMT entry. The PMT entry number is 


CALLING SEQUENCE: LDA A 


returned in A. 




LDB T 


Instruction Trap: 




LDX T 
BRS 33 


1. A user program tries to relabel 


a system SMT entry. 




2. The SMT number is not valid. 




A Address of string pointer 
T Terminal character 


Memory Trap: 




F File number 


There were no free PMT entries. 




Bit of A set= The string is taken as null with the second pointer equal to the first. 


REGISTER AFFECTED: A 




DESCRIPTION: This BRS reads characters from the file and appends them to the string until 
the terminal character is reached. The terminal character is not appended to the string. 
It returns the updated string pointers in the A and B registers and updates the end string 
pointer in memory. 

REGISTERS AFFECTED: A, B 


NUMBER: 34 






NAME: OUTMSG 






FUNCTION: Output Message 






STATUS: User 






CALLING SEQUENCE: LDX F 






LDA W 






LDB C 






BRS 34 






F File number 






W Beginning word address 






C Character count or -1 






DESCRIPTION: This BRS outputs C consecutive characters starting with the first character 






of the specified word. If B = -1, characters are output until a / is encountered; the char- 






acter $ is interpreted as a carriage return and line feed. 






REGISTERS AFFECTED: None 
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NAME: CIT 


NUMBER: 35 


FUNCTION: Character Input and Test 


NAME: OUTSTR 


STATUS: User 


FUNCTION: Output String 


CALLING SEQUENCE: LDA N 


STATUS: User 


CIT F 


CALLING SEQUENCE: LDX F 
LDA P 


EXCEPTION RETURN 
NORMAL RETURN 


LDB P+1 


N Character to be tested 


BRS 35 


F File Number (see CIO Input Only) 


F File number 


DESCRIPTION: The character In the A register is compared against the next character in 


P, P+1 A string pointer pair 


the input file. If it compares, the normal return is taken and the character is removed from i 


DESCRIPTION: Outputs the string indicated by the string pointers in registers A and B to 
the specified file. 


the input buffer. If it does not compere, the character is left in the input buffer and is 
returned in A, If the input buffer is empty the user will be dismissed until the next break character. 


REGISTERS AFFECTED: None 


Exception Return: A The next character in the input buffer 
B & X No change 




N A The character supplied remains in A (the character is 




removed from the input buffer). 




REGISTERS AFFECTED: A 


NUMBER: BE+U 




NAME: 


NAME: SKSE 


FUNCTION: Input String with Edit 


FUNCTION: Skip String Equal 


STATUS: User 


STATUS: User 




CALLING SEQUENCE: LDA B 




LDB E 




SKSE A 




EXCEPTION RETURN 




NORMAL RETURN 




A Address of a string pointer pair 




B Beginning string pointer 


NOT IMPLEMENTED 


E End string pointer 




DESCRIPTION: If the string addressed by the pointers in the A and B registers is identical 




with the string addressed by A of the calling sequence, control will be transferred to the 




normal return. Otherwise, control will be transferred to the exception return. If the strings 




are of different lengths or have different contents, control will be transferred to the exception 




return. 




REGISTERS AFFECTED: None 
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NUMBER: 37 




NUMBER: 5 


NAME: GSLOOK 




NAME: SSCH 


FUNCTION: General String Lookup 




FUNCTION: Look Up Spring in Hash Table 


STATUS: User 




STATUS: User 


CALLING SEQUENCE: LDA F 




CALLING SEQUENCE: LDA P 


LDB S 




LDB P+1 


LDX T 




LDX T 


BRS 37 




BRS 5 


EXCEPTION RETURN 




EXCEPTION RETURN 


NORMAL RETURN 




NORMAL RETURN 


F Input file number 




P and P+1 String pointers for a string to be looked up 


S Address of string pointer pair 




T Address of a three-word table (see control section FDCTL of a hash table) 


T Address of the Hash Table Control Table 




with the format: 


DESCRIPTION: The hash table is scanned for a string to match the given one. If none is 




ZRO Hash Table Beginning Address 


found but the given string matches the initial part of some hash table string characters from 




ZRO Hash Table End Address 


the input file are appended until the string is long enough either to determine a unique hash 




ZRO (working cell) 


table string, with a matching initial part, or for no match to be possible. In the former 




DESCRIPTION: BRS 5 searches the hash table for a string to match the string indicated by 
A and B registers. If successful, it returns in register B the address of the hash table string 
pointers (the location of the first entry of the three hash table entries), and in register A, 


case, more characters are taken from input until an exact match is obtained or no match is 
possible; in this latter case, the match is still valid, and the last character (which caused 
the mismatch) is left irS the input file. 




the "hash value" (the third word of the hash table entry) and executes the normal return. 


Exits are as follows: (1) The exception return is taken of the no-match condition with a 




Otherwise, it executes tlie "exception" return with registers A, B and X unchanged and the 


string pointer in A, B to the string so far collected. X is undisturbed. (2) The normal return 




address of the next free hash table entry in word 3 of the table. (Word 3 will be -1 if the 


is taken on a match with the address of a hash table string pointer in A and the "hash value" 




table is full.) 


in B. X is undisturbed. 




See BRS 6. 


The "hash value" is the third word of a hash table entry. 




REGISTERS AFFECTED: A, B 


REGISTERS AFFECTED: None 




NAME: LDP 






FUNCTION: Load Pointers 






STATUS: User 






CALLING SEQUENCE: LDP A 






A Address of a string pointer pair. 






DESCRIPTION: This SYSPOP loads the string pointers indicated in the calling sequence into 






the A &B registers. 






REGISTERS AFFECTED: A, B 
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NUMBER: 6 

NAME: SSIN 

FUNCTION: Insert String in Hash Table 

STATUS: User 

CALLING SEQUENCE: A, B, &X must have the output from BRS 5 
BRS 6 

DESCRIPTION: BRS 6 inserts the string pointer into the hash table at the point determined 
by the last BRS 5 which did not find a match. If the hash table is full (word 3 of the table 
pointed to by X is -1) an "Illegal Instruction" trap results. BRS 6 is intended for use in 
conjunction with BRS 5. It should be used only after BRS 5 has failed to find a match. 
Furthermore, litnng pointers should not be placed in the hash table in any manner other than 
with BRS 6 (otherwise the scanning algorithm used in BRS 5 may cause undesired results). 

BRS 6 does not physically move the string to which registers A and B point. On return, 
register B contains the address of the first word of the new hash table entry and register A 
contains the "value" word of the entry. 

REGISTERS AFFECTED: A, B 



NAME: STP 

FUNCTION: Store Pointers 

STATUS: User 

CALLING SEQUENCE: STP A 

A Address of a string pointer pair. 

DESCRIPTION: This SYSPOP is generally used in conjunction with LDP. It stores the con- 
tents of the A and B registers into the string pointers indicated in the calling sequence. 

REGISTERS AFFECTED: None 
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NAME: SKSG 

FUNCTION: Skip on String Greater 

STATUS: User 

CALLING SEQUENCE: LDA B 
LDB E 

SKSG A 
EXCEPTION RETURN 
NORMAL RETURN 

B Beginning string pointer 

E End string pointer 

A Address of a string pointer pair 

DESCRIPTION: The SYSPOP compares the string indicated by A and B registers with the 
string indicated by A of the calling sequence, character by character and terminotes with 
the first unequal character. The numerical internal code representation of characters is 
used to determine inequality. If the strings are unequal for the entire length of the shorter 
one, the longer one is indicated as greater. If the contents of the string addressed by the A 
and B registers is greater than the contents of the string addressed by A, control will be 
transferred to the normal return. Otherwise, control is transferred to the exception return. 

REGISTERS AFFECTED: None 



NAME: GCI 

FUNCTION: Get Character and Increment 

STATUS: User 

CALLING SEQUENCE: GCI A 

EXCEPTION RETURN 

NORMAL RETURN 

A Address of a string pointer pair 

DESCRIPTION: This SYSPOP reads into the A register, the first character from the string 
indicated by the beginning string pointer given in the calling sequence. If the string is null 
or empty, nothing is done and control is transferred to the exception return. If the string is 
not null its first character is loaded into the A register right-justified, and the beginning 
string pointer is incremented by one such that the beginning string pointer now points to the 
string with the first character deleted. Control is transferred to the normal return. Unless a 
copy of the original pointer is saved, the contents of the string are effectively destroyed. 

REGISTER AFFECTED: A 
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NAME: WCl 

FUNCTION: Write Cnaracter and Increment 

STATUS: User 

CALLING SEQUENCE: WCI P 

P Address of string pointer pair 

DESCRIPTION: WCI writes the character in the A register on the end of the string addressed 
by the end string pointer. The end string pointer is incremented by I. 

REGISTER AFFECTED: B 



NAME: GCD 

FUNCTION: Get Character and Decrement 

STATUS: User 

CALLING SEQUENCE: GCD P 

EXCEPTION RETURN 
NORMAL RETURN 

P Address of a string pointer pair 

DESCRIPTION: A GCD is, in every way, similar to GCI except that the character is taken 
from the end of the specified string. 

The lost character on the string is loaded in the A register, and end string pointer is decre- 
mented so that it points to the previous character in the string. Control is transferred to the 
exception return if the end pointer is not greater than the beginning pointer before it is 
decremented. 

REGISTER AFFECTED: N 
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NAME: WCD 

FUNCTION: Writes Character and Decrement 

STATUS: User 

CALLING SEQUENCE: WCD P 

P Address of a string pointer pair 

DESCRIPTION: This SYSPOP writes the character in the A register on the beginning of the 
string and decrements the beginning string pointer. 

REGISTERS AFFECTED: None 



NAME: WCH 

FUNCTION: Write Character 

STATUS: User 

CALLING SEQUENCE: LDA 
WCH 



C A character right-justified in the A register 

T The address of a three word table. The table is as follows: 

Word A character address 

Word 1 A character address 

Word 2 A transfer address 

DESCRIPTION: This SYSPOP tries to write a character into the area defined by the charac- 
ter addresses in the table. Provided that the second address In the table is greater than the 
first address, WCH will write the character in A register into the character position indi- 
cated by the first character address plus one and will increment the first character address in 
the table. If the first character address is equal to or greater than the second character in 
the table the character is not written and control is transferred to the third word of the table 
with A and X registers undisturbed and the address of the WCH in the B register. The address 
in the third word of the table can be an exit to a routine which allocates more memory or 
GARBAGE collects the remaining characters. 

REGISTERS AFFECTED: None 
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25. NUMBERS 



F 
N 
R 
36 



NUMBER: 36 

NAME: OUTNUM 

FUNCTION: Output Number 

STATUS: User 

CALLING SEQUENCE: LDX 
LDA 
LDB 
BRS 

F File number 

N Number to be output 

R Radix 

DESCRIPTION: Outputs a number in the radix R. The number will be output as an unsigned 
24-bit integer. If the radix is less than 2, an instruction trap will be given. 

REGISTERS AFFECTED: None 



NUMBER: 38 
NAME: GETNUM 
FUNCTION: Read Number 
STATUS: User 



CALLING SEQUENCE: 


LDX 


F 




LDB 


R 




BRS 


38 


F File number 






R Radix 







DESCRIPTION: Inputs an integer to any radix. The number may be preceded by a plus or 
minus sign. On exit the number will be in the A register. The conversion is terminated by 
any non-numeric character which will be in the B register on exit. The number is computed 
by multiplying the number obtained at each stage by the radix and adding the new digit. 

REGISTERS AFFECTED: A, B 
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NUMBER: 52 

NAME: FFI 

FUNCTION: Fomiatted Input 

STATUS: User 

CALLING SEQUENCE: LDX FORMAT 
BRS 52 

BRU X 

DESCRIPTION: This routine reads characters from a file specified in the format word, 
FORMAT. FORMAT also specifies the format of the input. Free form input from the 
teletype results when FORMAT = 0. A skip return is generated if and only if (1) the 
input is free form, and (2) the input is flooting point. The internal translation of the 
input file is stored in A, B, 

REGISTERS AFFECTED: A, B, X 



NUMBER: 53 

NAME: FFO 

FUNCTION: Formatted Output 

STATUS: User 

CALLING SEQUENCE: LDX 
BRS 



FORMAT 
53 



DESCRIPTION: The integer in A or the double word floating point value in A, B is output 
to the file according to the file number and format specified in FORMAT. 

REGISTERS AFFECTED: None 
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NAME: SIC 

FUNCTION; String to Internal Conversion 

STATUS: User 

CALLING SEQUENCE: LDX FORMAT 

SIC POINTER 

BRU INTEGER 

BRU FLOATING 

DESCRIPTION: See String Processing System documents. FORMAT describes the type of 
conversion to be done. 

The contents of POINTER point to the character immediately preceding the character string. 
POINTER+1 contains the character address of the last character of the string. 

INTEGER and FLOATING are routines that handle the converted input. Error flags, if 
applicable, are in the index register A, double word value corresponding to the string is 
in A, B upon return. 

REGISTERS AFFECTED: A, B, X 



NAME: ISC 

FUNCTION: Converts Internal Numbers to Formatted Output Strings 

STATUS: User 

CALLING SEQUENCE: LDP M 

LDX FORMAT 
ISC POINTER 

DESCRIPTION: See String Processing Documents. FORMAT describes the type of conver- 
sion to be done. The contents of POINTER point to the character Immediately preceding 
the character string. POINTER+1 contains the character address of the character immedi- 
ately preceding the position where the first character of output is to go. M, M+1 contain 
the floating point word to be converted. Pointer + 1 Is incremented once for each character 
added to the string. 

REGISTERS AFFECTED: A, B, X 
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NUMBER: 50 

NAME: FFIX 

FUNCTION: Conversion from Floating Point to Fixed Point 

STATUS: User 

CALLING SEQUENCE: BRS 50 

DESCRIPTION: Fixes the double word floating point value in (A, B). The Integer part Is 
left In A. The fractional port Is left adjusted In B. 

REGISTERS AFFECTED: A, B 



NUMBER: 51 

NAME: FFLT 

FUNCTION: Conversion from Fixed Point to Floating Point 

STATUS: User 

CALLING SEQUENCE: BRS 51 

DESCRIPTION: The Integer in A Is converted to a normalized floating point value In A, B. 

REGISTERS AFFECTED: A, B 



134 



NUMBER: 21 

NAME: FNA 

FUNCTION: Floating Negate 

STATUS: Uter 

CALLING SEQUENCE: BRS 21 

DESCRIPTION: The double word floating point value in the A and B registers is negated. 

REGISTERS AFFECTED: A, B 



NAME: FAD 

FUNCTION: Floating Point addition 

STATUS: User 

CALLING SEQUENCE: FAD N 

DESCRIPTION: SYSPOP FAD (A, B) + (M, M+1) 

A floating addition is performed to the contents of memory location M cand M+1 and the A 

and B registers. The results are left in the A and B registers. 



REGISTERS AFFECTED: A, B 
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NAME: FSB 

FUNCTION: Floating Point Subtraction 

STATUS: User 

CALLING SEQUENCE: FSB N 

DESCRIPTION: (A, B) - (M, M+1) 

The contents of memory locations M and M+1 are subtracted (floating subtraction) from the 

contents of the A and B registers. The results are left in the A and B registers. 

REGISTERS AFFECTED: A, B 



NAME: FMP 

FUNCTION: Floating Point Multiplication 

STATUS: User 

CALLING SEQUENCE: FMP M 

DESCRIPTION: (A, B) * (M, M+1) 

The contents of memory locations M and M+1 are multiplied (floating multiplication) by the 

A and B registers and the results left in the A and B registers. 



REGISTERS AFFECTED: A, B 
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NAME: FDV 




26. EXECUTIVE COMMAND OPERATIONS 


FUNCTION: Floating Point Divide 






STATUS: User 






CALLING SEQUENCE: FDV M 




NUMBER: 95 


DESCRIPTION: (A, B)/(M,M+1) 




NAME: EC DUMP 


The contents of the A and B registers are 


divided (floating divide) by the contents of memory 


FUNCTION: Dump 


locations M and M+1 with the quotient 


eft in the A and B registers. 


STATUS: User 


REGISTERS AFFECTED: A, B 




CALLING SEQUENCE: LDA N 
BRS 95 

N File number , 

DESCRIPTION: This BRS writes the entire current state of the machine (user's program only) 
on the specified file, which is made type 4. The status of the pseudo-relabeling registers 
and all information necessary to restart the user from his current situation are written on the 
dump file so it can be restored by a recovery procedure. The only information not preserved 
are any shared memory entries which may be in the pseudo-relabeling. 

Note: Dumps created by one system cannot be recovered by another. 

REGISTERS AFFECTED: All 






NUMBER: 96 






NAME: ECRECV 






FUNCTION: Recover 






STATUS: User 






CALLING SEQUENCE: LDA N 






BRS 96 






N File number 






DESCRIPTION: This BRS reads the dump file written by a BRS 95 and recovers the machine 






status as it appeared at the time the dump was taken. 






REGISTERS AFFECTED: All 
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27. MISCELLANEOUS OPERATIONS 


NUMBER: 88 
NAME: RTEX 




NUMBER: 42 

NAME: RREAL 

FUNCTION: Read Real-Time Clock 

STATUS: Us«r 


FUNCTION: Read Execution Time 

STATUS: System 

CALLING SEQUENCE: BRS 88 

DESCRIPTION: Returns the execution time in A in 60 cycle clock 
since log in. 


ticks accumulated 


CALLING SEQUENCE: BRS 42 


REGISTER AFFECTED: A 




DESCRIPTION: Read the real-time clock in the A register. Time is given as a 24-bit 
binary number representing 60ths of a second. The clock Is set to zero v/hen the system is 
started and it is incremented by one at every l/60th second. A binary form of the month, 
date and start-up time is put in B. From A and B the user can calculate the month, date 
and time. 




' 


REGISTERS AFFECTED: A, B 






NUMBER: 91 


NUMBER: 41 




NAME: EXRTIM 


NAME: lORET 




FUNCTION: Read Data and Time into a String 


FUNCTION: Return from I/O Subroutine 




STATUS: User 


STATUS: User 




CALLING SEQUENCE: LDA S 


CALLING SEQUENCE: BRS 41 




LDB S+1 
BRS 91 


DESCRIPTION: This is used by the author of an I/O subroutine to 


return to the calling 


S Beginning string pointer 
S+1 Ending string pointer 


program. 

REGISTER AFFECTED: A 




DESCRIPTION: The current date and time are appended to the string provided in A and B 
registers and the resulting string pointers are returned in the A and B registers. The char- 
acters appended to the string have the form: 






MM/dd hh:mm 






MM=Month 

dd =Day 

hh =Hours counted from to 24 

mm =Minutes 






REGISTERS AFFECTED: None 
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NUMBER: 111 


NUMBER: 71 


NAME: BRSRET 


NAME: SKXEC 


FUNCTION: Return from Class 3 BRS 


FUNCTION: Skip if System 


STATUS: System 


STATUS: User 


CALLING SEQUENCE: BRS 111 


CALLING SEQUENCE: BRS 71 


DESCRIPTION: This BRS is used only by the author of class 3 BRS's. It is the only normal 
termination of a class 3 BRS. If corresponds to a BRS 10 for other forks. 


DESCRIPTION: The B register is set to the value of the use code which the user has set for 
the job. These values are: 


Instruction Trap: 


Value of B Use Code 


BRS issued by a fork which was not a class 3 BRS. 


1 Subsystem User 


REGISTERS AFFECTED: None 


User 
-1 Both 




-2 System 




The BRS skips if the B register is negative. 




REGISTER AFFECTED: B 


NUMBER: 112 


NUMBER: BE+5 


NAME: TSOFF 


NAME: SDBM 


FUNCTION: Turn Off Teletype Station 


FUNCTION: Set Disc Bit Mop 


STATUS: System 


STATUS: System 


CALLING SEQUENCE: LDX Job Number 


CALLING SEQUENCE: LDA Address of X block Mod 4 


BRS 112 


BRS BE+5 


DESCRIPTION: This BRS is known as suicide. The job disappears completely from the 
system. 


EXCEPTION RETURN 
NORMAL RETURN 


The teletype line associated with the job will be set ready for another job if he merely 


Exception Return - A contains address that was in conflict. 


logged out. 


DESCRIPTION: Turns off bits in the disc bit map for the X block and each data block refer- 


REGISTERS AFFECTED: All 


enced by the index block. If any conflicts occur (the bit is already off), the address is left 
in the A register and the exception return is taken, A conflict also increments one of two 




counters, XBERR or FDERR, for errors in the X block or the file directory respectively. 




When the bit map has been set, one more call is made to this BRS with A negative. At that 




time a switch is set allowing output files to be opened; the new overflow pointer is set from 




B and the accounting area pointer is set from X. 




REGISTER AFFECTED: A 
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NUMBER: BE+8 




NAME: CRASH 


NUMBER: BRS BE+16 


FUNCTION: To Crash the System 


NAME: MFSYS 


STATUS: System 


FUNCTION: Set Executive -1 


CALLING SEQUENCE: BRS BE+8 


STATUS: SYSTEM 


NO RETURN 


CALLING SEQUENCE: LDA =765432108 


DESCRIPTION: Saves the registers in SSOl, SS02, SS03. Saves in MCRO. Turns off the 


BRS BE+16 


clock and disables the interrupts. Moves the TS block into real page 7 and the current 


DESCRIPTION: Simulates execution of the Executive command -SET EXEC -1. Executive 


relabeled page into real page 6. 


status (indicated by PAC table word PQU bit 0) is given to the fork that executes this BRS. 


REGISTER AFFECTED: None 


The user must have either operator or subsystem status assigned to him in order to execute 
this BRS. 




REGISTERS AFFECTED: NONE 


NUMBER: BE+13 


NUMBER: 152 


NAME: SETSW 


NAME: EXS 


FUNCTION: Sets System Exec Switches in COMPG file. 


FUNCTION: Execute Instruction in System Mode 


STATUS: System 


STATUS: System 


CALLING SEQUENCE: LDA V 


CALLING SEQUENCE: EXS I 


LDX N 
BRS BE+13 


I Address of the instruction to be executed 


NORMAL RETURN 


DESCRIPTION: This SYSPOP will cause the instruction pointed to by I to be executed in 


V New sv/itch value 


the system mode. 


N Switch number 




DESCRIPTION: The switch is set to the new value and the old value is returned in A. 


REGISTERS AFFECTED: Depends on instruction. 


REGISTER AFFECTED: A 
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APPENDIX A. GLOSSARY OF TERMS 



ACTPU: Phantom User Activation Counter. If positive 
when scheduler is entered, causes phantom user to be 
moved from QQE to QTI. 

ACTR: I/O Activation Counter, ACTR is incremented each 
time a fork that is on QTI or QIO is ready. Set to -1 
when the scheduler begins searching QSQ, 

AUNN: Account And User Number. Indexed by job. 
Inactive contains 0. 

B 

BLK31: Flag used in W buffer interrupt routine, 
=0 When W channel is not in use 

= 1 When disc is active 

= Address of the interrupt routine for the appro- 

priate driver when any W buffer device 
(except disc) is active 

breakpoint switch: Refers to the four toggle switches phys- 
ically located on the computer console. 



command file: The particular file from which the commands 
to the system Executive and subsystems are input. For 
teletype input the command file number is zero. 

corresponding table: Contains file directory information. 
Each entry is 3 words. The relative position of the 
entry corresponds to the position found in the file 
directory hash table by the execution of a BRS 5, The 
corresponding table contains data about the file, e, g,, 
file size, type, creation date, etc. 

customer file directory: The names of all files for a partic- 
ular user name are recorded in this directory. 



DSU block: Four consecutive sectors on the disc whose 
beginning addresses are MOD 4, A block consists of 
256 words. 

DSU file: A file stored on the disc storage unit. Each file 
consists of an index block, and if the file contains 
data, then a sufficient number of DSU blocks to record 
the data. 

DRQ: The disc queue. Each entry requires 3 locations. 

DSWAP: Paper tape routine used at system Initialization 
to fill the first 14K from disc to core. 



DTXS1: Contains the count (minus 1) of the number of 

commands the disc driver wishes to add to disc queue. 

DTXS2: Temporary location used by the disc software. 
Points to the location in DRQ where a command was 
just added, i.e., the value of EDCL before it was 
incremented by three, 

E 

EDCL: Points to the location in DRQ where the disc driver 
should add the next disc command. After a command 
is added, EDCL is incremented by three and wrapped 
around if necessary. 

ETTB: Elapsed time table. One entry per job, TJOB 
points to the ETTB for the running job. One of the 
ETTB entries is incremented with each clock tick for 
the purpose of charging compute time, 

F 

file number: A file number is assigned by the system to files 
as they are opened. Also, there are fixed file numbers 
for certain devices. These are as follows: 

Teletype Input 

1 Teletype output 

2 Nothing 

file type: There are four standard file types. They are as 
follows: 

1, File written by the system Executive as commanded 
by the "SAVE" command. 

2, General binary file created by a subsystem, i.e., 
a FORTRAN object program. 

3. Symbolic file. 

4. Dump file. 

FPLST: One word pointer to next free PAC table, indi- 
cates all PAC tables in use, 

FPLST: One word pointer to next free PUCT table entry in 
Phantom user queue. 

FULST: One word pointer to next free job number, 

I 

IDCL: Points to the command in DRQ that the interrupt 
routine will initiate when the Interrupt for the IDCLl 
command is received, 

IDCLl: Pointer to the entry In DRQ for which I/O trans- 
mission is currently in progress. 
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IDMRET: Flag that =0 when the interrupt routine (I DM) is 
entered as a result of a subroutine call. =-1 when 
entered as a response to an interrupt, 

index block: A DSU block (256 words) which contains the 
DSU addresses for all data blocks of a file. 

INT31: Address of W buffer genera (interrupt routine. This 
routine handles all W buffer I/O except disc. This 
routine branches indirectly to address specified inBLKSl 

J 

JOB: Contains the JOB number of the running fork. 

M 

MAC: Number of unlocked pages minus 1. Used by swapper. 

N 

NCMEM: Number of entries in SMT table. (60B.) 

NDCL: Contains the count (minus 1) of the number of com- 
mands that are on the disc queue and are ready for the 
disc interrupt routine to process. The interrupt routine 
will sequentially pull commands off DRQ and execute 
them until NDCL has the value -1. At this point there 
are no more commands on DRQ that are ready to be 
executed. 

NPPAR: Number of entries in a PAC table. 

NPUQ: Number of tasks that can be put on the Phantom 
User. 

NTTY: Number of teletypes. 

NUMEM: Number of entries In each PMT table. (20B.) 



OVFP: Overflow file directory flog. -1 means that this 
user has not been assigned an overflow file directory. 
When an overflow file directory has been assigned, 
OVFP contains a pointer too disc overflow file directory. 



PAC table: Each fork is defined by a program active table. 
This table contains most of the Information required to 
control selection, execution and interruption of the fork 
(additional information is stored in the user's TS page). 

PACPTR: One word in Monitor that contains the PACT 
pointer of the currently active fork. 

page: A page can exist on RAD, DSU or in-core memory 
but in all cases refers to 2048 words. 

panic: A panic is a signal to the system to terminate execu- 
tion of a fork. 

panic, instruction: A panic caused by attempting to execute 
an instruction which cannot be executed in the user 
mode, such as a halt or device I/O instruction or a 
BRS which is not available to the user. 



panic, memory: A panic caused by a fork attempting to 
address memory outside its range or write on memory 
which is set to read only. 

panic table: 

Word 

Program Counter 

1 A Register 

2 B Register 

3 X Register 

4 First Relabeling Register 

5 Second Relabeling Register 

6 Status 

The status word may be: 

-2 Dismissed for Input/Output 
-1 Running 

Dismissed on Escape or BRS 10 

1 Dismissed on Illegal Instruction Panic 

2 Dismissed on Memory Panic 

A panic table must not overlap a page boundary. 

PB: Table in TS page. 8 words long. Used for saving B 

register for corresponding fork. Indexed by fork num- 
ber (XPB). 

PIM: Word in PAC table. Contains Interrupt mask, fork 
number, etc. 

PL: Word in PACT where location counter Is saved (P 
register). 

PMT: Pseudo Memory Table. One PMT table per job. 

Pointed to by PMTP (which Is Indexed by job number). 
Each PMT table is 16 words long. The 16 words cor- 
respond to the users virtual 32K of memory. The 
pseudo-relabeling bytes have values 60B-77B. 

PMTJOB: A location which contains the starting address of 
the current users PMT table using SMT as a reference. 
PMTJOB is used by the swapper (in conjunction with the 
pseudo-relabeling byte) to retrieve entries from PMT. 

PMTP: One entry per job. Indexed by job number. Points 
to users PMT table. 

PNEXT: Word In PACT that Is used to chain the PAC tables 
when they are on the queues. If PNEXT is negative it 
contains a PACT pointer to the next PAC table on the 
queues. If PNEXT is positive It points to the next queue. 

PPTR: Word In PAC table. Contains the up poInter(PFORK) 
and down pointer (PDOWN) to other PAC tables In its 
forking structure. If on free PACT list (PAC table not 
in use) has the absolute address of the next free PAC 
table. 
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PQU: Word in PAC table. Contains long quantum, Execu- 
tive bits, etc. 

PTAB: Word In PAC table. Contains job number, panic 
table, address, etc. 

PTEST: Word in PAC table. Contains activation condition. 

PUBPTR: Pointer to first task on Phantom User queue. 

PUCLST: Phantom User task activation test list. Indexed 
by test number. Dispatches to where the decision is 
made as to whether the Phantom User Is ready to per- 
form this task. 

PUCSET: Phantom User task activation list. Indexed by 
test number. Represents a dispatch list for the various 
tasks that the Phantom User performs. 

PUCT: The Phantom User task queue. Each task queue entry 
consists of four words. 

PUCTR: Shows count of the number of tasks put on the 
Phantom User queue. When PUCTR=0 there are no 
tasks on the Phantom User queue and he is dismissed to 
either QTI or QQE. 

PUCTR 1: When the system begins to search the PU task 
queue, PUCTRl is set to PUCTR. If after the entire 
PUCT table is scanned, PUCTRl is still equal to PUCTR, 
It indicates that the PU was not able to process any of 
his tasks and no interrupts occurred that placed a new 
task on PUCT. If this Is the case, the PU Is placed 
on QQE. 

PEUPTR: Pointer to the last task on the Phantom User queue. 

PULIM: Phantom User Limit. Limits the number of tasks 
that can be put on the PU queue. This parameter Is 
established when the Monitor is assembled. Causes a 
crash if limit exceeded. 

PX: Table In TS page. 8 words long. Used for saving X 
register for corresponding fork. Indexed by fork 
number (XPB). 



QIO: Queue of programs dismissed for I/O other than TTY 
I/O. Forks that ore activated by on escape, software 
interrupt, or panic are also on QIO. 

QQE: Queue of programs dismissed for exceeding their long 
quantum. 

QSQ: Queue of programs dismissed when short quantum 
has expired and other programs on QTI or QTO are 
ready to run. 

QTI: Queue of programs dismissed for TTY input/output. 

quantum, long time: The maximum length of time a fork can 
run before the scheduler checks for other forks to be run. 



quantum, short time: The minimum length of time a fork 
will run before the scheduler checks for other forks to 
be run which were dismissed for I/O. 



Real: Real-time counter. Incremented by clock interrupt 
routine. Initialized when system Is brought up. 

Relabeling, pseudo: See format of relabeling registers. Each 
byte points to an SMT or PMT entry. 

relabeling registers: The relabeling registers are used to 
Indicate a page number which has been assigned to a 
use fora particular logical page. Theyareof the form: 

First word Page Page 1 Page 2 Page 3 

Second word Page 4 Page 5 Page 6 Page 7 

RLTS: Contains real page number of running forks temporary 
storage (TS) page. 

RLl: Word In PAC table. Contains the first pseudo relabel- 
ing word for the fork. 

RL2: Word In PAC table. Contains the second pseudo re- 
labeling word for the fork. 

RL3: Pseudo relabeling table for TS page. Indexed by job 
number. 

RMC: Real memory count table. Indexed by real page num- 
ber. Contains a -1 If page is unlocked. Contains a 
value greater then -1 If page is locked. 

RMT: Real Memory Table. One entry for each page of 
memory. Points to the PMT or SMT entry responsible 
for having this page in core. 

RRLl: Contains the real relabeling for register 1. This word 
Is potted out to the hardware register. 

RRL2: Applies to relabeling register 2. See RRLl. 

RRL3: Applies to Monitor relabeling register. See RRLl. 



SMT: Shared Memory Table. Only one SMT in the system. 
60B words long. Indexed by pseudo-relabeling values 
0-57B. The reentrant programs have entries In SMT. 

SSRLl: Two words In TS page that Indicate the subsystem 

used. The pseudo-relabeling for the system is fetched 
from the subsystem corresponding table and loaded into 
these two words. 

string pointers: A pair of pointers which contain a character 
address of the character before the first character of a 
string and a character address of the last character 
of the string. 
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SWOFF: Word in TS used by Executive. -1 means user 
has logged on or is in the process of logging on. Used 
by Executive to determine whether $ dump should be 
effected. 

SWTM: Word in TS used by Executive to determine log on 
status of user. 

=0 means time ran out while user is logging on 

(1.5 mins) 

= - 1 user is in the process of logging on or has 

logged on 

SYSTL: Word in TS block which contains the hash table ad- 
dress of the subsystem in use. 



TIIS5: Indexed by channel number. Used when software 
is processing carriage returns and line feeds. 

= if last character output was not a CR or LF 

Bit 23=1 when software has sent a CR 

Bit 23=0 when software has sent a LF 

TIME: Contains the short quantum for the running fork. 

TJOB: Word which points to job time counter table (ETTB). 
Used to increment compute time for a job. When the 
clock interrupt occurs. A MIN *TJOB is performed 
and the running job is charged. See ETTB. 

TTIME: Word where the total time (long time quantum) is 
maintained for the running fork. 



TTNO: Contains TTY channel number. Indexed it by job 
number. If active, TTNO contains channel number. 
If inactive, contains the chain for the free job numbers. 

TTYASG: TTY assigned table. Indexed it by channel num- 
ber. If active, it contains the PACTPTR of the fork to 
terminate in case of rubout. If inactive, contains 
37777B. 

u 

UNO: Set to user number when a user has logged on the 
system. 

User Name: The alphanumeric characters the user inputs 
after typing in the password and semicolon or CR. The 
name can be a maximum of 12 characters and may con- 
tain any character except semicolon, right paren, or 
CR. A unique user number is associated with each user 
name. A user name must only be unique within an 
account. 

User Number: A 4-digit octal number which is unique to 
each user name. The user number is assigned by the 
operator. The user number is a pointer to the file 
directory associated with a particular user name. 

UTTY: One word in the system which contains the channel 
number of the running fork. 

W 

WERIS: State of the teletype line. Indexed by channel 
number. 

-1 Line free 

User is in the process of logging on 

>0 User number for the user on this teletype 



148 Appendix A 



APPENDIX B. BRS AND SYSPOP INDEXES 



INDEX OF BRS'S AND SYSPOP'S BY NUMBER 



BRSs 


Function 


Page 


1 


Open file of a specific device 


86 


2 


Close a file 


88 


4 


Release a page of memory 


115 


5 


Look up string in hash table 


125 


6 


Insert string in hash table 


127 


8 


Close all files 


89 


9 


Open fork 


78 


10 


Terminates the calling fork 


83 


11 


Clear the teletype Input buffer 


109 


12 


Declare echo table 


110 


13 


Test input buffer for empty 


111 


14 


Delay until the TTY output buffer is empty 


112 


15^ 


Read input file name 


98 


16t 


Open input file in file directory 


99 


17t 


Close all files 


99 


18^ 


Read a file name and look it up in the file directory 


100 


19^ 


Open output file located in file directory 


101 


20^ 


Close a tape file 


89 


21 


Floating point negate 


135 


23 


Link/unlink specified TTY 


106 


24 


Unlink all TTYs 


106 


25 


Set teletype to accept/refuse links 


107 


26 


Skip if escape waiting 


77 


29 


Clear the output buffer 


110 


30 


Read status of a lower fork 


79 


31 


Wait for specific fork to cause a panic 


82 


32 


Terminates a specified lower fork 


84 


33^^ 


Read string 


122 


34^^ 


Output message 


122 


35^^ 


Output string 


123 


36^t 


Output number to specified radix 


131 


37^t 


General string look up 


126 


38^^ 


Input number to specified radix 


131 


40 


Read echo table 


111 


41 


Return from l/O subroutine 


140 


42 


Read real-time clock 


139 


43 


Read pseudo-relabeling 


116 


44 


Set pseudo-relabeling 


117 


45 


Dismiss on quantum overflow 


80 


46 


Turn escape off 


76 


47 


Turn escape on 


76 


48^ 


Lock up input/output file name 


102 


49 


Read interrupts armed 


74 


50 


Conversion from floating point to fixed point 


134 


51 


Conversion from fixed point to floating point 


134 


52^ 


Formatted floating point input 


132 


53^ 


Formatted floating point output 


132 


56 


Make page system 


119 


57 


Guarantee 16 ms computing 


79 


60^ 


Look up l/O file name and insert in file directory if not found 


102 


Class 3 (Executive) BRS 




••Class 2 BRS 
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BRSs 


Function 


Page 


66 


Delete DSU file data 


90 


67 


Delete DSU file index block 


90 


69 


Get SMT block to PMT 


121 


71 


Skip if in system 


142 


72 


System dismissal 


81 


73 


Terminates a specified number of lower forks 


84 


78 


Arm/disarm software interrupts 


73 


79 


Cause specified software interrupts 


74 


80 


Make page read only 


119 


81 


Dismiss for specified amount of time 


81 


85 


Set special TTY output 


112 


86 


Clear special TTY output 


113 


87 


Read DSU file index block 


91 


88 


Read execution time 


140 


90 


Declare a fork for escape 


7^ 


91^ 


Read date and time into a string 


139 


95^ 


Dump program and status on file 


138 


96^ 


Recover program and status from file 


138 


104 


Read a page (2048 words) from RAD 


91 


105 


Write a page (2048 words) to RAD 


92 


106 


Wait for any fork to terminate 


82 


107 


Read status of all lower forks 


80 


108 


Terminate all lower forks 


85 


109 


Dismiss calling fork 


83 


110 


Read device and unit 


88 


111 


Return from exec BRS (exec only) 


141 


112 


Turn off teletype station (exec only) 


141 


113 


Compute file size of a disc file 


92 


116 


Read user relabeling 


117 


117 


Set user relabeling 


118 


118 


Allocate magnetic tape unit 


93 


119 


De-allocate magnetic tape unit 


93 


120 


Assign PMT entry 


116 


121 


Release specified page from PMT 


115 


122 


Simulate memory panic 


118 


BE+1 


Read DSU 


95 


BE+2 


Write DSU 


96 


BE+3 


Test for carrier present (not implemented) 




BE+4 


Read/write one word in the Monitor 


120 


BE+5 


Set disc bit map 


142 


BE4^ 


Turn a teletype line on or off 


109 


BE+7 


Test a breakpoint switch 


95 


BE+8 


To crash the system for error diagnostic 


143 


BE+9 


Read DSU page 


94 


BE+10 


Write DSU page 


94 


BE + 11 


Ignore line feed or carriage return (not Implemented) 




BE+12 


Arm timing interrupt 


75 


BE+13 


Sets system Executive switches in COMPG 


143 


BE+15 


Read SMT page from RAD 


96 


BE+16 


Set EXEC =-1 


144 


BE+17 


Test if last buffer used 


97 


BE+19^ 


Get file creation date and access count 


97 


Vlass 3 (Executive) BRS 
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SYSPOPs 


Function 


Page 


BIO 


Block input/output 


104 


CIO 


Character input/output 


103 


CIT 


Character Input and test 


124 


CTRL 


Input/output control 


105 


EXS 


Execute instruction in system mode 


140 


FAD 


Floating point addition 


125 


FDV 


Floating point division 


137 


FMP 


Floating point multiplication 


136 


FSB 


Floating point subtract 


136 


GCD 


Get character from end of string and decrement end pointer 


129 


GCI 


Get character from beginning of string and increment beginning pointer 


128 


ISC 


Internal to string conversion 


133 


LDP 


Load string pointer 


125 


OST 


Output to specific TTY 


114 


SKSE 


Skip if string equal 


124 


SKSG 


Skip if string greater 


128 


SIC 


String to internal conversion 


133 


STP 


Store string pointer 


127 


TCI 


Teletype character input 


113 


TCO 


Teletype character output 


114 


WCD 


Put character on beginning of string and decrement beginning pointer 


130 


WCH 


Write character to memory by table 


130 


WCI 


Put character on end of string and increment end pointer 


129 


WIO 


Word input/output 


103 



INDEX OF BRS'S AND SYSPOP'S BY TYPE 

SCHEDULING, FORKS AND PROGRAM INTERACTION 

PROGRAM INTERRUPTS 



BRSs or SYSPOPs 


Function 


Page 


78 
79 
49 
BE+12 


Arm/disarm software Interrupts 
Cause specified software Interrupts 
Determines which software Interrupts are armed 
Arm timing interrupt 


73 
74 
74 
75 



CONTROL OF THE ESCAPE KEY 



BRSs or SYSPOPs 


Function 


Page 


90 
46 
47 
26 


Declare a fork for escape 

Turn escape off 

Turn escape on 

Skip If escape waiting 


75 
76 
76 
77 



ACTIVATION OF FORKS 



BRSs or SYSPOPs 


Function 


Page 


9 
57 


Open fork 

Guarantee 16 ms computing 


78 
79 
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INTERROGATION OF A FORK 



BRSs or SYSPOPs 


Function 


Page 


30 
107 


Read status of o lower fork 
Read status of all lower forks 


79 
80 



TEMPORARY SUSPENSION OF FORKS 



BRSs or SYSPOPs 


Function 


Page 


45 


Dismiss on quantum overflow 


80 


72 


Executive dismissal 


81 


81 


Dismiss for specified amount of time 


81 


31 


Wait for specific fork to cause a panic 


82 


106 


Wait for any fork to terminate 


82 


109 


Dismiss calling fork 


83 



TERMINATION OF A FORK 



BRSs or SYSPOPs 


Function 


Page 


10 
32 
73 
108 


Terminates the calling fork 
Terminates a specified lower fork 
Terminates a specified number of lower forks 
Terminate all lower forks 


83 
84 
84 
85 



INPUT/OUTPUT 



DIRECT CONTROL OF PERIPHERALS 



BRSs or SYSPOPs 


Function 


Page 


1 


Open a file of a specific device 


86 


110 


Read device and unit 


88 


2 


Close a file 


88 


20 


Close a tape file 


89 


8 


Close all files 


89 


66 


Delete DSU file data 


90 


67 


Delete DSU file index block 


90 


87 


Read DSU file index block 


91 


104 


Read a page (2048 words) from RAD 


91 


105 


Write a page (2048 words) to RAD 


92 


113 


Compute file size of a disc file 


92 


118 


Allocate magnetic tape unit 


93 


119 


Deallocate magnetic tape unit 


93 


BE+1 


Read DSU 


95 


BE+2 


Write DSU 


96 


BE+7 


Test a breakpoint switch 


95 


BE+9 


Read DSU page 


94 


BE+10 


Write DSU page 


94 


BE+15 


Read SMT page from RAD 


96 


BE+17 


Test for last buffer used 


97 
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CONTROL OF FILES VIA FILE NAMES 



BRSs or SYSPOPs 


Function 


Page 


15 


Read Input file name 


98 


16 


Open input file in file directory 


99 


17 


Close all files 


99 


18 


Read a file nome and look it up in the file directory 


100 


19 


Open output file located in file directory 


101 


48 


Look up input/output file name 


102 


60 


Look up l/O file name and insert in file directory if not found 


102 


BE+19 


Read file creation date and access count 


97 



I/O OPERATIONS 



BRSs or SYSPOPs 


Function 


Page 


BIO 
CIO 
CTRL 

WIO 


Block input/output 
Character input/output 
Input/output control (tape) 
Word input/output 


104 
103 
105 
103 



TELETYPE OPERATIONS 



LINKING AND ATTACHING 



BRSs or SYSPOPs 


Function 


Page 


23 
24 
25 

BE+3 

BE+6 

_. 


Link/unlink specified TTY 

Unlink all TTYs 

Set teletype to accept/refuse links 

Test for carrier present (not implemented) 

Turn a teletype line on or off 


106 
106 
107 

109 



INPUT/OUTPUT OPERATIONS 



BRSs or SYSPOPs 


Function 


Page 


11 


Clear the teletype input buffer 


109 


12 


Declare echo table 


no 


13 


Test input buffer for empty 


m 


14 


Delay until the TTY output buffer is empty 


112 


29 


Clear the output buffer 


no 


40 


Read echo table 


in 


85 


Set special TTY output 


112 


86 


Clear special TTY output 


113 


BE+11 


Ignore line feed or carriage return when followed by carriage return or line 
feed respectively (not Implemented) 




OST 


Output to specific TTY 


114 


TCI 


Teletype character Input 


113 


TCO 


Teletype character output 


114 



Appendix B 153 



MEMORY OPERATIONS 

PRIVATE MEMORY 



BRSs or SYSPOPs 


Function 


Page 


4 


Release a page of memory 


115 


43 


Read pseudo relabeling 


116 


44 


Sjt pseudo relabeling 


117 


56 


Make page executive 


119 


80 


Make page read only 


119 


116 


Read user relabeling 


117 


117 


Set user relabeling 


118 


120 


Acquire a new page 


116 


121 


Release specified page from PMT 


115 


122 


Simulate memory panic 


118 


BE+4 


Read/write one word in the Monitor 


120 



SHARED MEMORY 



BRSs or SYSPOPs 


Function 


Page 


69 


Get SMT block to PMT 


121 



STRING PROCESS 

STRING I/O 



BRSs or SYSPOPs 


Function 


Page 


33 
34 
35 
CIT 


Read string 
Output message 
Output string 
Character input and test 


122 
122 
123 
124 



HASH TABLE SEARCH 



BRSs or SYSPOPs 


Function 


Page 


5 
6 
37 


Look up string in hash table 
General string look up 
Insert string in hash table 


125 
127 
126 



STRING MANIPULATION 



BRSs or SYSPOPs 


Function 


Page 


LDP 
SKSE 
SKSG 
STP 


Load string pointer 
Skip if string equal 
Skip if string greater 
Store string pointer 


125 
124 
128 
127 
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CHARACTER MANIPULATION 



BRSs or SYSPOPs 


Function 


Page 


GCI 

GCD 

WCD 

WCH 

WCI 


Get character from beginning of string and increment beginning pointer 

Get character from end of string and decrement end pointer 

Put character on beginning of string and decrement beginning pointer 

Write character to memory by table 

Put character on end of string and increment end pointer 


128 
129 
130 
130 
129 



NUMBER OPERATIONS 

NUMBER I/O 



BRSs or SYSPOPs 


Function 


Page 


36 


Output number to specified radix 


131 


38 


Input number to specified radix 


131 


52 


Formatted floating point input 


132 


53 


Formatted floating point output 


132 


ISC 


Internal to string conversion 


133 


SIC 


String to internal conversion 


133 



ARITHMETIC OPERATIONS 



BRSs or SYSPOPs 


Function 


Page 


21 


Floating point negate 


135 


50 


Conversion from floating point to fixed point 


134 


51 


Conversion from fixed point to floating point 


134 


FAD 


Floating point addition 


135 


FDV 


Floating point division 


137 


FMP 


Floating point multiplication 


136 


FSB 


Floating point subtract 


136 



EXECUTIVE COMMAND OPERATIONS 



BRSs or SYSPOPs 


Function 


Page 


95 
96 


Dump program and status on file 
Recover program and status from file 


138 
138 



MISCELLANEOUS OPERATIONS 



BRSs or SYSPOPs 


Function 


Page 


41 


Return from I/O subroutine 


140 


42 


Read real-time clock 


139 


71 


Skip If executive 


142 


88 


Read execution time 


140 


91 


Read date and time Into a string 


139 


111 


Return from 


141 


112 


Turn off teletype station (Exec only) 


141 


BE+5 


Set disc bit map 


142 


BE +8 


To crash the system for error diagnostic 


143 


BE+13 


Sets Exec switches in COMPG 


143 


BE+16 


Set Executive status 


144 


EXS 


Execute Instruction In system mode 


140 
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APPENDIX C. GENERAL DESCRIPTION OF THE COMBINED FILE DIRECTORY 



A user may have one or two file directory blocks on the disc; 
the second block is an overflow block. Each block consists 
of 128 words containing a variable number of file directory 
entries. Each entry is in the format pictured below. 

If the first word of the block is zero, the block is considered 
to be empty. The last entry is followed by a -1 or -2 word 
where the -1 indicates additional entries in the overflow 
block. 



FILE DIRECTORY BLOCK 



128 

Words 



4 Control words 



Variable length name 



End dir. flag -1 or -2 



Available storage for unused 
entries 



Overflow block pointer 



Accumulated real-time (con- 
nect time) 



Accumulated computer time 



Valid on time (1 bit per hour) 



Number of 
entries 
depends on 
length of 
file name 



Last -3 
Last -2 
Last -1 
Last word 



N 



FILE DIRECTORY FORMAT ON DISC OR TAPE 



Account No. 


No. 


of accesses 


Creation date 


89 


14 15 23 


CC 





File length (FL) 


1 2 


11 12 23 


CB 


FT 


LTP 


Future controls (currently 
not used) 


2 3 56 


11 12 23 


Index block 


pointer (disc file) 



23 



HTP 





FS (tape file) 



5 6 89 



23 



? 


Char of name 





Char of name 


^ 


Char of 
name 



1 



7 89 



151617 23 



F 


Char of name 


Char or 136 (fill) 


Char or 

136 (fill) 



1 



1516 



23 



Account No. 
C2, etc. 



41 would be account Dl, 32 account 



In the case of an overflow block, the last three words are 0, 
and the overflow block pointer is a backward pointer to the 
first file directory block (i.e., UNO). 

The user number (UNO) is a pointer to the disc address of 
the user's file directory. The available user numbers vary 
with the number of discs. Suppose an installation has a disc 
configuration to allow user numbers to range from 1 through 
1377B. An arbitrary decision could be made to assign user 
numbers 1 through 1077B, thus allowing number 1 lOOB through 
1377B for overflow file directories. The overflow file direc- 
tory pointer is actually a "fictitious user number". 

The variable LUNO (Last User Number) designates the end 
of the overflow file directory area. In the above example 
LUNO would be set to 1377B and SOV (Start of Overflow 
area) would equal llOOB. NOVP would be initialized to 
LUNO and decremented each time an overflow file directory 
Is assigned. 



No. of Accesses Number of times the file was ac- 

cessed since last disc reordering. Reaches a maxi- 
mum of 778 and remains there until next disc edit. 

Creation Date Bits 15-18 are the month number less 

one. Bits 19-23 are the day of the month less one; 
for example, 154 is April 13. 

CC Indicate a change In file size (the file was writ- 

ten on). These bits are used by the concurrent tape 
back-up routine and the disc file edit routine. 

FL File length for disc files where each bit represents 

one data block of 255 words. 



CB File control bits, = Tape file 

2 = Disc file 



FT File type (1 through 4) 
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LTP Low order tope positron; for example, if LTP = 5, 

this is the fifth file on a multi-file tape. 

F End of entry flag 

HTP High order tape position 

FS Tope file size 

USER ACCOUNT DIRECTORY ON DISC 

Words 1 2 3 4 5 6 7 



Acct, password 



8 


User 


Name 


1 


13 


User 


Name 


2 


18 


User 


Name 


3 


23 


User 


Name 


4 


28 


User 


Name 


5 


33 


User 


Name 


6 


38 


User 


Name 


7 


43 


User 


Name 


8 


48 


User 


Name 


9 


53 


User 


Name 


10 


58 


User 


Name 


11 


63 


P 







CA 



c 


N 


c 


N 


c 


N 


c 


N 


c 


N 


c 


N 


c 


N 


c 


N 


c 


N 


c 


N 


c 


N 







CA This word could be used to contain status 

parameters that apply to the entire account. Cur- 
rently it is not used. 

na is not assigned 

C is a control parameter 

N is a user number 

p is reserved for an overflow pointer and not pres- 

ently used. 

The control parameter bits are assigned as follows: 



11 12 



23 



Bit 


Use 





System status 


1 


Control 


2 


Operator status 


3 


Subsystem status 


4,5 


Not assigned 


6, 11 


Subsystem classes 
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APPENDIX D. RESIDENT MONITOR FILES 



BRS 



Contains the BRS dispatcher and the routines associated with miscellaneous BRSs. The trap routines, the 
memory allocation routine and the routines necessary to set up and maintain the forking structure are here. 



CNTRS All of the counters that are used for statistical purposes are here. If the assembly parameter called CNTPKG 

is set to -1, this file is not needed. 

COMPG This file contains some of the constants that are used by the Executive and Monitor, the job indexed tables, 

some of the teletype tables, and various error counters. 



DISC 



This file contains the opening and closing routines and the drivers for the disc. However, the disc queue and 
interrupt routine are in the lOP file. 



INIT 



This file is used to initialize the system. The DSWAP routine reals the first 14K of the Monitor from the disc 
and branches to SETSET which reads the INIT file from the disc. 



lOP 



This file pertains to the I/O devices and file logic. The file control tables and device tables are here. The 
131 and 133 interrupt routines and the opening and closing routines are here. lOP contains the general logic 
for the devices that are on the W-buffer. The drivers for a particular device will be found in either DISC or 
WPAGE. 



MCONST This file contains the systems configuration dependent parameters, such as number of discs, RAD, description 

of peripherals, size of buffers, etc. It also contains OPDs and macros. This file is nongenerative (contains 
only assembly directives) and is used only when the Monitor is assembled. 



PMTS 



This file contains the scheduled queues, the PMT and SMT tables, and the PAC tables. 



RAD 



Contains the RAD driver, interrupt routine, and RAD queue. 



SCHDR Contains the routines that are necessary to dismiss one user and activate another. The scheduler, the swapper, 

the Phantom User, the clock interrupt routines, the software interrupt routine, and the crash routine are 
here. 

STRNG Contains the routines associated with string processing. The routines used for constructing and maintaining 

the hash tables are here. The floating point POPs are also here. 



TTY 



This file contains the routines that are associated with the teletype, the five interrupt routines, the TCO and 
TCI SYSPOPs, the majority of the tables indexed by teletype number, the teletype buffers and various routines 
that the Phantom User performs that are associated with the teletype, such as rubouts and the initialization of 
the Executive for a user, are here. 



USERP User page (TS page). This file provides a map of the symbols used mainly by the Executive. The TS page serves 

to make the Executive reentrant. Each user has a TS page with the format shown by this file. 

WPAGE This file contains the drivers for all of the devices, except the disc, that are on the W-buffer. 
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LOGICAL 
MEMORY 



REAL 
MEMORY 



Page 



Location 



4140 
5001 



12535 



17122 

22760 
23704 

25503 
25771 



lOP 




lOP 








COMPG 




COMPG 








TTY 




TTY 








SCHDR 




SCHDR 


BRS 




BRS 


RAD 




RAD 


STRNG 
CNTRS 
PATCH 


- 


STRNG 
CNTRS 
PATCH 


PMTS or 
DISC or 
WPAGE 


PMTS 


INIT or 
USERP 





-A_ 



10 



11 



12 



13 



14 



15 



16 



17 



DISC 



WPAGE 



[NIT 



Note: The Monitor relabeling register refers to pages 6 and 7. The locations that the Monitor 
files occupy were obtained from a typical Monitor assembly. The lOP, PMTS, DISC, 
WPAGE and INIT files are loaded on page boundaries. 



Figure 34. Memory Diagram for the Monitor 
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APPENDIX E. THE EXECUTIVE FILES 

EXCNS The file contains various parameters and MACROS that are used at system generation for the Executive. The file 

consists of all nongenerative assembler directives. 

GSBR This file consists of a collection of general subroutines that are used by the Executive. 

CMNDS This file contains the command processor for the Executive. An escape to the Executive transfers control to this 

file. The routines associated with the Executive commands or a transfer to the routines are in this file. The com- 
mand and subsystem hash tables are here. 

CMND2 This file contains the logic necessary for logging a user on and off the system, plus the Executive commands that 
are not in CMNDS. 

INTLE This file is both assembled and executed when the Executive is generated. The routine that sets up the commands 

and subsystem hash tables is here. 



Page 


1 

2 
3 
4 


Location 


Logical 
Memory 


SMT/PMT Byte 


4140 

13334 
17710 
23762 


USERP 




60 B 
OIB 
lOB 
IIB 
13B 






COMPG 








GSBR 








CMNDS 


_. 




CMND2 












Note: 


The locations that the Executive files occupy were obtained 
from a typical assembly. 



Figure 35. Memory Diagram for the Executive 
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APPENDIX F. INITIALIZATION AND ASSIGNMENT OF THE PAC TABLES 

Assume there are only five PAC tables in the system and the tables begin at location lOOB, (Actually there are 144 tables that 
are located in the PMT file,) 

NPAC EQU 5 

NPPAR EQU 10 (10 entries per PACT) 

lOOB PACT BSS NPAC * NPPAR 

PEND EQU 

PNEXT EQU PEND+0 

PL EQU PEND + 1 

PA EQU PEND +2 



PPTR 



EQU 



PEND +5 



PIM 



EQU 



PEND +9 



When the program is assembled, the following values will be assigned; 
Symbol Value 



PACT 


lOOB 


PEND 


162B 


PNEXT 


162B 


PL 


163B 


PA 


164B 


PPTR 


167B 



When the system is initialized (in INIT), the following values are inserted into the PAC tables. See Figure 36. 



Note: Only the PPTR word of each table is shown. 







Location 


PACT 

PACT + 5(PPTR) 

PPTR (2nd table) 

PPTR (3rd table) 

PPTR (4th table) 

PPTR (5th table) 




lOOB 
105B 

117B 

131B 

143B 

155B 

FPLST - 1 17R 









131B 






143B 






155B 


















Figure 36. Initialization of PAC Tables 
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Note that the PPTR word of each table points to the loca- 
tion of the PPTR word of the next available PAC table. The 
PPTR word of the last PAC table contains a zero indicating 
that there are no more available tables. 



In order to retrieve entries from the PAC table, there Is a 
PACT pointer associated with each PAC table. The pointer 
for the currently active fork in the system is always stored 
into location PACPTR. The PACT pointer is a negative num- 
ber that allows the PAC table entries to be addressed using 
the end of the tables (see definition of PNEXT, PA, etc.) 
as the point of reference. 

When the system is initialized the Phantom User is assigned 
the first PAC table. Location FPLST always contains the 
address of the PPTR word of the next available table. If the 
address of the PPTR word of an available table is known, the 
PACT pointer can easily be calculated. 

Considering the above example, the following values would 
be assigned at system initialization: 



FPLST 



117B 



PUPACP = -62B = PACT pointer of Phantom User 

When the Phantom User is active, the following coding 
would retrieve his PAC table entries: 



INST 



LDX 



LDA 



PUPACP 



PA,2 



LDA PIM,2 



Fetch PA word 



Fetch PIM word 



The effective address of the instruction at INST would be: 

PA = 164B 

(X) = -62B PACT pointer of Phantom User 

Effective Address = 164 -62 = 102B = Address of PA 
entry for Phantom User 

When a user comes on the system or any fork is declared, a 
PAC table must be assigned. Coding very similar to the fol- 
lowing is executed in subroutine GFK: 



Get point to a free table. 
Are there any free tables. 

Calculate PACT pointer. 
Copy A to X; clear A. 
Get pointertonext free table. 
FPLST updated. 
Save PACT pointer 



Once the PACT pointer is assigned, it is stored into the 
PNEXT word of the fork previous to it on the scheduled 
queues or it is available in the PDOWN or PFORK entries 
is the fork was dismissed to activate a lower fork. 

When a fork is terminated, the PAC table associated with 
the fork is returned to the free PACT list. Coding similar 
to the following Is performed: 



LDA 


FPLST 


SKG 


= 


BRU 


NOROOM 


SUB 


=PPTR 


COPY 


AX, A 


XMA 


PPTR, 2 


STA 


FPLST 


STX 


TEMP 



LDX 


PACPTR 


Get pointer for this fork. 


COPY 


XA 




ADD 


= PPTR 


Get address of PPTR word of 
this table. 


XMA 


FPLST 




STA 


PPTR, 2 





Note that FPLST is pointing to the table that has just been 
released. PPTR of the table that has just been released Is 
pointing to another free PAC table (I.e., as a fork termi- 
nates the PAC table is added to the top of the list of free 
tables). 

The method that is used for the assignment of PAC tables is 
similar to the method used for the assigning of the job and 
file numbers. 

The TTNO table contains the chained list of free job num- 
bers. Location FULST contains the next available job num- 
ber. The FA table and location FFLST are used In conjunc- 
tion with the file numbers. 
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APPENDIX G. INITIALIZATION OF SYSTEM AND ACTIVATION OF FIRST USER 



The dashed line represents the teletype 
on interrupt 



I 



TNI 



EPU 



EPU puts task on Phantom User 



DSWAP 



SETSET 



SETSA 



PACGOl 



PACGO 



PACSCN 



PEST 



PACACT 



PGET 



QGET 



ACT 



Bring in first 14K of Monitor. 



Read the INIT file. from disc. 



1 Initialize tables, arm teletype interrupts, 
activate 2 phone lines, arm clock, enable 
interrupt system. 



Charge time to system overhead. 



Set a pointer to search QTI, 



Begin searching a queue. 



Find an activatable fork. If all Qs have 
been searched, go to PACGO, 



Initiate swap for this fork. Put fork on 
swap Q. 



Call swapper. Charge time to this user. 



Get this fork off the scheduled queues. 



Search swap Q for a fork whose memory is 
core resident, PU wil I always have his memory. 



ACT2 



PGET 



Take fork off swap Q, 



Verify that this fork has all his memory. 



PACSRT 



Establish this fork's environment. Activate 
him by a BRU* on PL word. 
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APPENDIX H. THE PHANTOM USER LOGIC 



PUGO 




yes 



PUSCN 



BRU* PUCLST,2 



yes 




PUNXT 



Initialize poinfer fo search beginning of PUCT table. 



PUDMS 



Search PUCT table for a task. 



PUCLST contains addresses of routines that determine whether 
PU can process a task; for example, it cannot process a rubout 
if NT bit set. 



If not at end of PUCT, go to PUSCN and continue searching. 
GO to PUSCN if an interrupt added a new PUCT entry. Put 
PU on QQE if nothing to do. 



PUACT1 



Flow enters at PUACTl or PUACT to process a task. Remove 
task from PUCT. 



BRU* PUCSET,2 



Execute task 



NPUGO 



PUCSET contains addresses of the routines that perform the 
PU tasks. 



All PU routines return to NPUGO. PMT page is relabeled in. 
The task may have required the use of DISC or WPAGE. 



PUDMS 



BRS 72 



Put PU on QTI. 



Dismiss. Note that the PTEST word contains an activation 
condition of 4, 
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APPENDIX I. PHANTOM USER LOGIC TO PROCESS A TELETYPE ON INTERRUPT 



BRU* 
PUCLST,2 



PUTDL 




PUACTl 



The activafion code for the ff on interrupf = 6. 



Make sure 4 sec have elapsed since interrupt occurred. 4 sec delay allows for TTY 
carrier to become stable. 



PUNXT 



Attempt to process next PUCT entry if 4 sec 
have not elapsed. 



Remove task from PUCT table. Decrement PUCTR. 



BRU* 
PUCLST,2 



TNI2+ 1 



TIP 



TSON 



Location PUTST contains TNI2+ 1, 



Make sure data set is ready and carrier is stable. 



TIP is a general despatcher for tt on, off, rubout, and BRS 112. 



Get job number, get PAC table for Executive fork, set up PAC table parameters, zero 
PMT table, set PL word to TSONI, put Executive PAC table on QTI. 



Format for PUCT table entry for teletype on interrupt: 

Word 
1 

2 
3 



Pointer to next task 


on 


PUCT 


6 


'c£ 


TNI2+1 






1 


.a) 


CN 









ci 


CN 







The 6 is the activation code used by PU logic. TNI2 + 1 is 
address of routine to process task. 

The 1 Is used by the dispatcher at TIP. 
Teletype channel number. 
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APPENDIX J. FLOW REQUIRED TO INITIALIZE THE EXECUTIVE WHEN 

A USER LOGS ON THE SYSTEM 

When the Phantom User processes a "teletype on" Interrupt, the PAC table for the Executive fork is initialized and put on QTI. 
When the Executive fork is activated It begins execution at TSONI. 



TSONI 



EXECI 



Get TS page for user, execute a BRU EXEC 1,4 to enter user mode. 



Sets up various parameters, allows 1-1/2 minutes for log on time. 
EXECI is the general entry point to the Executive from the Monitor. 



ABORT 



This is the general entry point after rubout. 



CR 



XENTER 



CR is general entry point to process Executive commands. The third page is re- 
labeled out since It Is used mainly during logging on and off. Since user has not 
logged on a branch is taken to XENTER where the third page is relabeled in and a 
branch to ENTER occurs. 



ENTER 



Types "READY" and "PLEASE LOG IN". Reads AUD and file directory. Verifies 
log In parameters. 



RENTER 



This Is the general entry point Into CMNDS from CMND2. Third page relabeled 
out. 



ABORT 



CR 



CRA 



Types the dash and begins to read the command. 



Interprets the command and takes appropriate action. 
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APPENDIX K. SUBROUTINE TRACE OF THE SWAPPER 



CHRL 



SWAP 



SWPl 

fhrough 

SWP41 



SWP2 



MAS 

through 

MA12 



SWPIO 



SWPl 2 

through 

SWP36 

SWP15 

through 

SWP23 



DCRL 



OMW 



OMR 



UPRL 



RTW 



RTC 



Load pseudo-relobeling Into A, B, X. 

Decode pseudo-relabeling Into SRT table. 
Pseudo Byte SRT Entry 

40B 



Page In core 

PMT entry on RAD 
SMT entry on RAD 



Real page number Including read-only 
bit (bits 18-23 of PMT) 

4 @ PMT address 

5 @ SMT address 



Lock page, reduce MAC for core resident pages. For pages that must be 
read, build the following tables: 

SWT5 -RAD address of page 

SWT14 - SRT entry of page 

SPT and SAT —These tables cross-reference each other. They allow 

the commands to be later inserted onto the RAD queue in a manner 
that Is optimum for RAD access. 

Check MAC to determine if there are enough unlocked pages to attempt to 
bring in this fork. 

Determine which pages will be swapped. The method for selection of 
pages is described in Chapter 5. The write commands are added to the 
SPT and SAT tables. SWT6 contains the first location In SWT5 that was 
not used by the read commands. 

SWT5 —Contains PMT/SMT entry of page to be swapped 

SWT14 — Contains RMT entry of page to be swapped 

If a read-only (RO) page is released, the In-use bit (bit of RMT) is reset 
so that later the system knows that it can put a request on the RAD queue 
to read into this page without waiting for the previous contents to be writ- 
ten out. Bit (on RAD) of the PMT entry that currently corresponds to this 
page is set. 

The current position of the RAD is obtained in order to pull commands from 
SPT and SAT in an optimum manner. 



The RAD requests are built from the Information in the SPT, SAT, SWT14, 
and SWT5 tables. A RAD read calls OMR while a RAD write calls OMW. 
The system distinguishes reads from writes by the SWT6 pointer. If a read 
and write command refer to the same page, the write command is entered 
onto the RAD queue before the read command. This is accomplished by 
examining bit (in use) of RMT. This bit is reset after a write command 
is added to read queue. 

Add write command to RAD queue. Lock page while RAD I/O is active. 



Adjust bits 0, 1, and 2 of RMT appropriately. If call for activation, insert 
swap queue (SWQ) pointer into RMT and adjust page count word of SWQ. 
The real page number is Inserted into PMT and bit of PMT Is reset. If the 
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SWP3 



RST 



PTRL 



RTC 



RTS 



PKRL 



call was from MGET (DROBIT of PMT set), RTC is not called since no 
read is required. 

Add read command to RAD queue. Lock page while RAD I/O is active. 

RST is called when all the commands are on RAD Q. Start the RAD, Do 
not wait for I/O to complete if call was for activation. Otherwise wait 
RDR and exit skipping if error occurred. 

PTRL calls PKRL to form the 3 hardware relabeling registers in A, B, and X, 
The read-only bit is set for all the bytes. 



CHRL+7 



LABEL 



SWAP exits skipping if successful. 

The real relabeling is stored into SRRLl, SRRL2, and SRRL3. An exit is 
taken if this was a call for activation. Otherwise the TS page is marked 
as being not read-only. The Monitor accesses the TS page and Monitor 
mapping does not include a read-only bit. The hardware relabeling is 
then set. 
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APPENDIX L. THE DISC LOGIC 



The software inifiat-es disc l/O by first placing an entry on- 
to the disc queue (DRQ). Each entry on the disc queue re- 
quires three locations. The format of a disc queue entry is 
shown in Figure 37. 

The disc drivers will add an entry to DRQ at the location 
Indicated by EDCL. Location NDCL contains the count 
(minus one) of the number of commands that are on the disc 
queue and are ready for the disc interrupt routine to process. 
The disc driver will increment NDCL when it adds an entry 
and the disc interrupt routine (IDM) will decrement NDCL 
when it processes an entry. IDM will sequentially pull com- 
mands off of DRQ and execute them until NDCL has the 
value -1 . At this point there are no more commands on 
DRQ that are ready to be executed. 



Word 


Disc Address 


1 



FN 


7 


8 


Real Core Address 


23 


2 


R 

1 


ETIME 


EN 


Word Count 



FN 



1 56-89 
File number 



23 



ETIME Estimate of the time (clock ticks) that 

this operation should require 

EN Index to the post-processing error routine 

that this operation should use 

R 1 for write, for read command 



Figure 37. A Disc Queue Entry 

Since both the disc drivers and the disc interrupt routine 
alter the contents of NDCL, the drivers must disable the 
interrupts while NDCL Is being adjusted. To make this pro- 
cess more efficient, the variable DTXSl is Implemented. 
Suppose the driver wished to perform an operation that re- 
quired the adding of two commands to DRQ. The driver 
would add both commands to DRQ and Increment DTXSl 
each time a command was added. Then the driver would 
disable the interrupts, adjust NDCL by the value indicated 
by DTXSl, and restore DTXSl too -1. Thus DTXSl con- 
tains the number of commands (minus 1 ) that the driver has 
added to DRQ for any given operation. 

The disc Interrupt routine Is entered In two ways: (IDMRET 
Indicates how IDM was entered.) 

1 . as a response to an Interrupt (IDMRET = -1) 

2. as a subroutine called by a disc driver (IDMRET = 0) 

If the disc Is inactive, the driver must not only add an 
entry to DRQ, but also Initiate the disc I/O by calling 
IDM. 



DRQ 



IDCLl -The I/O 
transmission for this 
entry is currently 
being processed. 

IDCL-Thel/Ofor 
this entry will be 
initiated when the 
interrupt for IDCLl 
is received. 



EDCL -The disc 
drivers will add an 
entry at this 
location. 



There are 3 words per entry. 

DRQ is dimensioned for NDRQ entries. 



Figure 38. The Disc Queue (DRQ) 

When IDM Is entered as a response to an Interrupt, the fol- 
lowing occurs: 

1 . The I/O for the next entry (if any) on DRQ will be 
Initiated. This entry Is pointed to by IDCL. 

2. The post-processing, I.e., error check, release locked 
pages, etc., will be done on the entry for which the 
Interrupt was received. This entry is pointed to by 
IDCLl. 

When IDM Is entered as a subroutine call, IDCLl will equal 
-1. The I/O for the first entry will be initiated and IDCLl 
will point to this entry. The next entry (If any) will be 
set up (the POT words will be contructed), and pointed 
to by IDCL. 

When IDM has finished executing all the requests on DRQ, 
IDCLl will be set to -1. 
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APPENDIX M. BRS LOGIC FLOW 



Save 
registers. 



Remove indirect 
ADR bit from 
memory 0. 




<^ TRAPB "^ 



Store transfer 
vector in BSX. 




Restore A 
register. 



SYSPOP mark 
word (MEM 0) 
to SBRSRT. 




PACPTR to 
X register. 




tUBRSE 



Execute 
transfer 
(EXU BSX). 



V 



Restore A & X 
registers. 



Execute 
transfer 
(BRU* BSX) 



V 




<^ TOAPB ^]> 



Set PQU word 
to full time 
+ X6 




Set PACT 
pseudo re I 
to 6001 1000,0 



Set PACT PL to 
40010003+lowei 
9 bits of BST word 



Set PTAB to X5, 
EXECL panic 
address & job 
number. 



Set up PA, PB 
& PX for new 
fork. 



Save old param- 
eters UBRLl, 
UBRL2,UBA, 
UBB,UBL&UBX 





Set PACT 
pseudo re I 
to 60011200,0 



Set PACT PL to 
WOlOOOO+Jower 
? bits of BST word. 



SMT entry: 10 = FLTIO file 
12 = GSBR file 
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APPENDIX N. TRACE OF THE SUBROUTINES WHICH ARE CALLED BY 
THE BRS 1 (MONOPNI IN ORDER TO OPEN THE DISC 



MONOPN 

BGET 



DRMOPN 



BSET 
DTC 
DTF 



DTS 



DTA 
DTZ 



I DM 
DTP 



Get a TS page buffer. 
Dispatch on OPNDEV table. 

The following path is taken (in DRMOPN) to open an old file. 

Get real address of buffer. 

Put command to read index block on disc queue. 

Set file number and index to error routine in disc queue entry. 

Increment count of number of commands on disc queue. 

This routine called only to start the disc if the disc is currently inactive. 

Reset DTXSl variable. 

The following path is taken (in DRMOPN) to open a new file. 

Allocate a disc block for the Index Block. 

Zero the area of TS buffer that the Index Block will occupy. 



APPENDIX 0. SUBROUTINE TRACE FOR BIO FLOW WHEN THE 
DEVICE IS THE DISC ON INPUT 



BIO 

BIS 
BIG 



lOl 



GPW 



GPWD 



NIODMS 

lODMS 
POPDMS 



ED 



BSET 

MPDSC 

DRMSI 



DTC 
DRF 
DTS 



MPPACT 



I DM 
DTP 



Block input/output. 

Return buffer address and FD word. 

Transfer all available words. 

BIG is entered when the data block in the buffer is empty, 

Find out it is the disc. 

Set up arguments for ED. 

Get buffer pointer and drive device. 

Get buffer address. 

Map in the disc page. 

Compute disc address. 

Put command on DRQ. 

Set file number, interrupt index in DRQ. 

Update DRQ command counts. 

Start disc (if currently inactive). 

Reset command count. 

Colls: 

Mop in PMT page. 

Moke up PTEST word: 11 @ FD + filenmbr, 

Dismiss fork . 
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APPENDIX P. SUBROUTINE TRACE FOR THE LOGOUT COMMAND 



LOGOUT 



KILL 6 Use BRS 121 to release memory of PMT entry 61 and following. 

BRS 8 Close all files. 

MKFD Output updated file directory to disc. 

WRACT Write system accounting. 

TIMER Print elapsed time message. 

BRS 14 Wait until elapsed time message is printed. 

BRS 4 Release TS page. 

BRS 112 The BRS 112 releases the job number, resets TTYASG and WERIS, releases PAC table for the Executive, 

removes any tasks that this teletype has on the PU queue, and finally puts a task on PU (the same as the 
teletype ON interrupt) to set up an Executive for this user. The system will set up an Executive fork 
and allow the user to relog on provided that he has not hung up. Also, a check is made to see if the 
operator has issued the SHUT DOWN command. If so, the teletype will be deactivated. 

APPENDIX Q. SUBROUTINE FLOW FOR THE PHANTOM USER TASK 
WHICH PROCESSES A TELETYPE OFF INTERRUPT 



TIP 



OFFINT 



LGOUT3 



TFIP 



OFDUM 
XDUMP 
OFINT2 
OFINTl 



BRS 14 
BRS 4 
BRS 112 



KILL 6 

BRS 8 

MKFD 

WRACT 

Go to LGOUT3 



HFK 
RFK 
TFK 

CLIB 
CLOB 



Get PACPTR of Executive fork. 

Set panic tables for entire forking structure. 

Release all PAC table in forking structure except Executive fork. The Executive fork is put 
on QIO. 

Clear input TTY buffer. 

Clear output TTY buffer. 

TFIP gives the Executive fork an immediate activation condition and sets the PL word to loca- 
tion OFFINT which is in the Executive. 

Decide if user is still logged on system. 

The following path is taken in OFFINT if the user is not logged on the system. 



Release TS page 

See subroutine trace of LOGOUT command (Appendix O). 

The following path is taken in OFFINT if the user is logged on the system. 

Clear SWOFF. 

Initialize for using /$/ Dump file. 

Check to see if user has a /$/ file. If so, the dump is taken. 
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